本文介绍在Ubuntu 18.04/CentOS 7操作系统上安装Wiki.js的方法。Wiki.js是一个基于Node.js、Git和Markdown的开源,现代且功能强大的wiki应用程序,它能在Linux、macOS和Windows操作系统上运行。服务器要求是:Node.js 6.9.0或更高版本、MongoDB 3.2或更高版本、Git 2.7.4或更高版本、符合Git的存储库(公共或私有),请注意,CentOS 7存储库上的git版本有点旧,参考在最小化安装CentOS 7.5系统中编译安装git 2.19.0版本一文,同时我们将使用Nginx来代理Wiki.js访问,使用pm2来启动应用程序。
一、安装Node.js 8.x和Nginx 在CentOS 7上: curl -sL https://rpm.nodesource.com/setup_8.x | sudo bash - sudo yum install -y nodejs nginx sudo yum install gcc-c++ make curl -sL https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo sudo yum install yarn 对于Ubuntu 18.04/Ubuntu 16.04系统: curl -sL https://deb.nodesource.com/setup_8.x | sudo bash - sudo apt -y install nodejs
二、安装MongoDB参考文章 Wiki.js在MongoDB数据库中存储管理数据,例如用户,权限和资产元数据。 文章内容和上传不存储在MongoDB中,相反,它们存储在磁盘上并自动与你选择的远程git存储库同步,参考: 在Ubuntu 18.04/16.04系统中安装MongoDB的方法。 在RHEL 8/CentOS 8系统上安装和配置MongoDB 4的方法。
三、下载并安装Wiki.js 创建一个项目目录: mkdir /srv/wikijs 切换到项目目录: cd /srv/wikijs 安装Wikijs: VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable) curl -L -s -S https://github.com/Requarks/wiki/releases/download/v1.0.102/wiki-js.tar.gz | tar xz -C . curl -L -s -S https://github.com/Requarks/wiki/releases/download/v1.0.102/node_modules.tar.gz | tar xz -C . 创建Wiki配置文件: cp -n config.sample.yml config.yml 要查看已安装的版本,请使用: # node wiki --version 1.0.102
四、配置Wiki.js 运行以下命令启动配置向导: node wiki configure 要使用自定义端口,请使用以下命令: node wiki configure 1234 其中1234是自定义端口,作为示例,我将配置Wiki.js以在我的服务器上使用端口8080: node wiki configure 8080 保持此终端处于活动状态并打开新的终端会话以配置nginx: sudo vim /etc/nginx/conf.d/wikijs.conf 对于没有ssl的http连接,请添加: server { listen 80; server_name wiki.example.com; location / { proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_pass http://127.0.0.1:8080; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_next_upstream error timeout http_502 http_503 http_504; } } 以下配置代码段用于http和https,但具有从http到https的重定向: # Redirect http to https server { listen 80; server_name wiki.example.com; return 301 https://$server_name$request_uri; } # Serve https traffic server { listen 443 ssl http2; server_name wiki.example.com; ssl_session_cache shared:SSL:50m; ssl_session_tickets off; ssl on; ssl_certificate /etc/letsencrypt/live/wiki.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/wiki.example.com/privkey.pem; ssl_session_timeout 5m; ssl_ciphers "EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH EDH+aRSA !RC4 !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS"; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_prefer_server_ciphers on; location / { proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_pass http://127.0.0.1:3000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_next_upstream error timeout http_502 http_503 http_504; } } 重新启动nginx服务并确保将其设置为在启动时启动: sudo systemctl restart nginx sudo systemctl enable nginx 在浏览器中打开http://wiki.example.com/链接并按照安装向导进行操作:
确保依赖性检查返回成功:
设置网站标题:
同时需要设置MongoDB数据库连接,如果你的MongoDB安装在与Wiki.js相同的主机上,请使用连接字符串:mongodb://localhost:27017/wiki:
安装成功后,将准备好开始页面:
登录Wiki.js控制面板开始添加内容:
要停止Wiki.js,请运行以下命令: node wiki stop 要重新启动Wiki.js,请运行以下命令: node wiki restart 在配置向导期间输入的所有设置都保存在config.yml文件中。
五、配置Wiki.js以在启动时启动 默认情况下,系统重启后Wiki.js不会自动启动,为了使它在启动时启动,我们需要将pm2设置为全局npm模块并将其设置为启动服务。 PM2是具有内置负载均衡器的Node.js应用程序的生产过程管理器: npm install -g pm2 我们现在需要告诉pm2将自己配置为启动服务: pm2 startup 最后,通过运行命令保存当前的pm2配置: pm2 save 通过以下方式删除init脚本: pm2 unstartup systemd 至此,配置Wiki.js在启动时启动操作完成,也意味着在Ubuntu 18.04/CentOS 7上安装Wiki.js完成。
相关主题 |