wipi
1.0.0
Wipi 是一個面向個人的開源的集成文章發表、頁面創建、知識小冊等功能的CMS 系統。涉及到的技術如下:
MySQL :數據存儲next.js :前端頁面框架nest.js :服務端框架AliyunOSS :對象存儲更多功能,歡迎訪問系統進行體驗。
首先安裝MySQL ,推薦使用docker 進行安裝。
docker image pull mysql:5.7
docker run -d --restart=always --name wipi -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root mysql:5.7然後在MySQL中創建數據庫。
docker container exec -it wipi bash ;
mysql -u root -p ;
CREATE DATABASE ` wipi ` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci ;首先,clone 項目。
git clone --depth=1 https://github.com/fantasticit/wipi.git your-project-name然後,安裝項目依賴。
# 全局安装 pnpm
npm i -g pnpm
pnpm installpnpm run dev前台頁面地址: http://localhost:3001 。 後台管理地址: http://localhost:3002 。 服務接口地址: http://localhost:3003 。
首次啟動,默認創建管理員用戶:admin,密碼:admin(可在.env文件中進行修改)。 [PS] 如服務端配置啟動失敗,請先確認MySQL 的配置是否正確,配置文件在.env 。
項目初次啟動時,需要在後台進行系統設置。隨著內容的豐富,頁面內容也會豐富起來。
默認加載.env文件,生產環境會嘗試加載.env.prod文件。
# 客户端运行端口
CLIENT_PORT=3001
# 客户端站点地址(假设部署到 https://xx.com, 就将 CLIENT_SITE_URL 设置为 https://xx.com)
CLIENT_SITE_URL=http://localhost:3001
# 客户端资源地址(假设部署到 https://xx.com,就将 CLIENT_ASSET_PREFIX 设置为 https://xx.com,如果将资源上传到 cdn ,那就改为 cdn 地址)
CLIENT_ASSET_PREFIX=/
# 管理后台运行端口
ADMIN_PORT=3002
# 管理后台资源地址(假设部署到 https://xx.com,就将 CLIENT_ASSET_PREFIX 设置为 https://xx.com,如果将资源上传到 cdn ,那就改为 cdn 地址)
ADMIN_ASSET_PREFIX=/
# 服务端运行端口
SERVER_PORT=3003
# 服务端完整访问路径
SERVER_API_URL=http://localhost:3003/api
# 服务端接口前缀(假设将希望通过 http://xx:com/api 来访问,那就设置为 /api;如果 http://xx:com,那就设置为 / )
SERVER_API_PREFIX=/api
# 默认管理员账户名
ADMIN_USER=admin
# 默认管理员账密码
ADMIN_PASSWD=admin
# 以下为数据库配置,请先创建好表
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=root
DB_PASSWD=root
DB_DATABASE=wipi
# Github 第三方登录配置
# 关于 Github OAuth 可参考 https://www.ruanyifeng.com/blog/2019/04/github-oauth.html
GITHUB_CLIENT_ID=0 # Github OAuth 登录 Id
GITHUB_CLIENT_SECRET=0 # Github OAuth 登录 Secret生產環境部署的腳本如下:
node -v
npm -v
npm config set registry http://registry.npmjs.org
npm i -g pm2 @nestjs/cli pnpm
pnpm install
pnpm run build
pnpm run pm2
pm2 startup
pm2 save採用反向代理進行nginx配置,同時設置proxy_set_header X-Real-IP $remote_addr;以便服務端獲取到真實ip 地址。
upstream wipi_client {
server 127.0.0.1:3000 ;
keepalive 64 ;
}
# http -> https 重定向
server {
listen 80 ;
server_name 域名;
rewrite ^(. * )$ https:// $host $1 permanent ;
}
server {
listen 443 ssl ;
server_name 域名;
ssl_certificate 证书存放路径;
ssl_certificate_key 证书存放路径;
location / {
proxy_http_version 1.1 ;
proxy_set_header Upgrade $http_upgrade ;
proxy_set_header Connection " upgrade " ;
proxy_set_header Host $host ;
proxy_set_header X-Nginx-Proxy true ;
proxy_cache_bypass $http_upgrade ;
proxy_pass http://wipi_client ; #反向代理
proxy_set_header X-Real-IP $remote_addr ;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ;
}
}