跳到主要内容

部署与维护

本页记录本站的构建与发布方式，供维护者参考。

架构​

本地/CI 构建  →  build/ 静态产物  →  上传到服务器  →  Nginx 直接分发

站点没有数据库、没有后端进程，所有页面在构建时预渲染为 HTML。

目录​

路径用途
/www/wwwroot/wiki.altcheats.com站点根目录，存放 build/ 的内容
/www/server/panel/vhost/nginx/wiki.altcheats.com.confNginx 站点配置
/www/wwwlogs/wiki.altcheats.com.log访问日志

构建​

npm install        # 安装依赖
npm run build      # 生成静态文件到 build/

构建使用 Node.js 20 及以上版本。产物是纯 html/css/js，可以直接丢给任何静态服务器。

发布​

# 把本地 build/ 同步到站点根目录，删除旧文件
rsync -av --delete build/ root@server:/www/wwwroot/wiki.altcheats.com/
chown -R www:www /www/wwwroot/wiki.altcheats.com

Nginx 要点​

静态站点需要把未命中的路径回退到 404.html，并关闭对 .map 等源文件的直接访问：

root /www/wwwroot/wiki.altcheats.com;
index index.html;

location / {
    try_files $uri $uri/ $uri.html /404.html;
}

回滚​

发布前保留一份旧产物即可快速回滚：

mv /www/wwwroot/wiki.altcheats.com /www/wwwroot/wiki.altcheats.com.bak
mv /www/wwwroot/wiki.altcheats.com.prev /www/wwwroot/wiki.altcheats.com