开发文档

一、环境要求

• Node.js 20+ + pnpm；PostgreSQL 15+；Redis（缓存/队列，建议同机 127.0.0.1）；
• 操作系统：Linux（推荐 Ubuntu 22.04 / Debian 12）；服务器内存建议 2G+（构建 Next.js 需要）；
• 需要域名 + HTTPS（Nginx 反代到应用端口）。

二、安装步骤（手工部署）

1. 装好 Node 20、pnpm、Postgres、Redis；
2. 上传源码到 /www/wwwroot/rhex/；
3. pnpm install 安装依赖；
4. 复制环境变量文件（.env.example → .env），填数据库连接串（DATABASE_URL=postgresql://用户:密码@127.0.0.1:5432/库名）、Redis、站点地址与各类密钥；
5. 建库并初始化表结构：pnpm prisma migrate deploy（开发环境用 prisma migrate dev）；可选 prisma db seed 写入初始数据（等级、看板等）；
6. 构建：pnpm build；
7. 启动：pnpm start（next start，默认 127.0.0.1:3000）；生产建议用 systemd 托管 Web 进程 与 Worker 进程（后台任务）两个服务；
8. Nginx 反代 https://你的域名 → 127.0.0.1:3000，证书用面板/ACME 签发。

三、Docker 部署（可选）

仓库自带 Dockerfile 与 docker-compose.yml（含 Postgres / Redis）：docker compose up -d --build 即可起全套；生产记得把 Postgres 数据目录挂出来做持久化。

四、安装后必做

• 建管理员：用种子脚本或直接在库里把某个用户设为管理员（权限表 AdminPermissionGrant + 角色）；
• 站点配置：站点名称、Logo、注册开关、发帖限制等在前台/后台设置里；
• Redis 必须可用：缓存与队列依赖它，没配好会出现「发帖后不刷新/任务不执行」；
• 备份：Postgres pg_dump + .env + 上传目录。

五、常见问题

• 改完代码没变化：忘了 pnpm build 或没重启服务；
• 构建内存不足被 kill：加 swap 或提高 NODE_OPTIONS=--max-old-space-size=2048；
• 页面 500 / Prisma 报错：迁移没跑（prisma migrate deploy）或 DATABASE_URL 不对；
• Node 脚本报找不到模块：脚本要放在项目目录里执行（依赖解析基于项目 node_modules）。