内网搭建文档管理系统

放纵的年华

前言


单位来了两位新同事，对于项目知道的又少，所具备的技能也不尽如人意。
两天相处下来感觉很是被动，因此觉得需要在单位内网环境部署一个文档系统，将日常遇到的问题记录下来。供他们参考学习和借鉴，也为未来的新同事提供一个良好的学习环境。还能够促进共同学习。

找了许多开源文档系统，觉得showdoc这个最合适，因此决定内网虚拟一台服务器，把服务部署上去

实现方式


内网部署centos7.9作为服务器，安装apache、php提供站点访问。

遇到的问题


1、内网环境如何上传站点文件？


单位内网的堡垒机为jumpserver，通过jumpserver的文档管理功能进行上传文件的操作。
详细内容参考这篇文章

对jumpserver具备的功能和实现方式不熟悉，导致在“如何上传文件到内网服务器上”这一问题纠结了很久，一直没想明白，也许是突然开窍了知道去找百度知乎帮忙了才解决的问题。

2、如何进行部署服务？


ShowDoc文档系统的官方文档给出了3中安装方式，自动脚本安装、手动安装、离线安装。通过查阅手册对比三种方式的实现难度，最终选择用手动部署环境的方式进行，不采用docker。

详细参阅

因此,我仅需要在CentOS上apache和php就可以。

[root@localhost]yum install httpd

[root@localhost]yum install php php-gd php-mcrypt php-mbstring php-mysql php-pdo php-zip

[root@localhost]systemctl enable httpd

[root@localhost]systemctl start httpd
然后将上传到服务器上的ShowDoc站点文件复制到/var/www/目录下即可进行下一步

3、如何进行apache配置？


光做好环境部署、站点文件上传还不够。要实现web访问还需要对apache进行配置，不然一直是测试页。
修改/etc/httpd/conf/httpd.conf中的三处内容
[root@localhost]vim /etc/httpd/conf/httpd.conf

## 修改DocumentRoot目录为站点所在目录
DocumentRoot "/var/www/showdoc-master"

## 修改Directory标签内的目录地址为站点所在目录
<Directory "/var/www/showdoc-master">
    AllowOverride None
    # Allow open access:
    Require all granted
</Directory>

## 修改DirectoryIndex的站点默认首页文件
<IfModule dir_module>
    DirectoryIndex index.php index.html
</IfModule>
保存退出后，需要修改文件所有者，因为在/etc/httpd/conf/httpd.conf文件中，站点拥有者是apache

##/etc/httpd/conf/httpd.conf文件中关于httpd运行所有者的标识

# User/Group: The name (or #number) of the user/group to run httpd as.
# It is usually good practice to create a dedicated user and group for
# running httpd, as with most system services.
#
User apache
Group apache

##因此需要对站点目录进行修改所有者
[root@localhost]chown -R apache:apache /var/www/showdoc-master
## 最后重启httpd服务
[root@localhost]systemctl restart httpd
总结


部署过程并不复杂，但是还是花了很长的时间去了解堡垒机、apache站点的部署方式等等。
发现这些以前虽然接触过，也用过，但是我好像对他们一点都不了解。就是那句老生常谈的话：知道的越多才发现自己知道的太少。

参考资料


1、[jumpserver上传文件](运维小白：JumpServer文件上传与下载)
2、[ShowDoc手册](ShowDoc)