搭建 ShowDoc 文档工具

程序员都很希望别人能写文档，而自己却不愿意写文档。文档的编写和管理影响了团队沟通协作的效率，ShowDoc 是一个非常适合 IT 团队的在线文档分享工具，为提升团队之间的沟通协作效率而生。

一、准备域名

域名注册、域名解析

解析

测试

二、使用自动脚本安装（前提是已经安装了docker环境，否则安装很慢）

下载脚本并赋予权限

wget https://www.showdoc.cc/script/showdoc

chmod +x showdoc

默认安装中文版。如果想安装英文版，请加上en参数，如 ./showdoc en

 ./showdoc

image

访问IP http://192.168.0.62:4999/

访问域名 http://wen.youadminwen.com:4999

部署完成

准备好域名后，手动搭建

yum install epel-release -y

安装 nginx

yum install nginx -y

配置nginx（把需要ip和路径修改一下就行）vim /etc/nginx/nginx.conf

usernginx;

worker_processesauto;

error_log/var/log/nginx/error.log;

pid/run/nginx.pid;

include/usr/share/nginx/modules/*.conf;

events {

    worker_connections 1024;

}

http {

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '

                      '$status $body_bytes_sent "$http_referer" '

                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile            on;

    tcp_nopush          on;

    tcp_nodelay         on;

    keepalive_timeout   65;

    types_hash_max_size 2048;

    include             /etc/nginx/mime.types;

    default_type        application/octet-stream;

    include /etc/nginx/conf.d/*.conf;

    server {

        listen       80;

        server_name  127.0.0.1;

        root         /var/www/html;

        index index.php index.html

        error_page  404              /404.html;

        location = /40x.html {

        }

        error_page   500 502 503 504  /50x.html;

        location = /50x.html {

        }

        location ~ .php$ {

            root           /var/www/html;

            fastcgi_pass   127.0.0.1:9000;

            fastcgi_index  index.php;

            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;

            include        fastcgi_params;

        }

        location ~ /.ht {

            deny  all;

        }

    }

}

注意：php 那里 192.168.0.11:9000; 不能写自己IP，需改为 127.0.0.1:9000 我那里写错了

image

检查、启动nginx，并设置为开机启动

nginx -t

systemctl start nginx.service

systemctl enable nginx.service

image

使用yum安装 php-fpm

yum install php php-gd php-fpm php-mcrypt php-mbstring php-mysql php-pdo -y

启动php-fpm，并设置为开机启动

systemctl start php-fpm.service 

systemctl enable php-fpm.service

下载安装Composer，Composer是PHP的一个依赖管理工具，推荐使用Composer创建ShowDoc项目

curl -sS https://getcomposer.org/installer| php

mv /root/composer.phar /usr/local/bin/composer

image

设置Composer使用国内镜像

composer config -g repo.packagist composer https://packagist.phpcomposer.com

使用Composer创建项目

cd /var/www/html/ && composer create-project  showdoc/showdoc

创建项目

设置showdoc目录写权限 chmod -R a+w showdoc/*

chmod a+w showdoc/install

chmod a+w showdoc/Sqlite

chmod a+w showdoc/Sqlite/showdoc.db.php

chmod a+w showdoc/Public/Uploads/

chmod a+w showdoc/Application/Runtime

chmod a+w showdoc/server/Application/Runtime

chmod a+w showdoc/Application/Common/Conf/config.php

chmod a+w showdoc/Application/Home/Conf/config.php