环境要求

操作系统

推荐使用以下 Linux 发行版之一：

• Debian 12 / Ubuntu 22.04 LTS 及以上；
• Rocky Linux 9 / AlmaLinux 9；
• 其他主流发行版需自行确认依赖包可用性。

生产环境建议使用 x86_64 架构。ARM64 可以运行，但需要自行编译或获取对应架构的依赖。

硬件建议

规模	团队人数	CPU	内存	磁盘
测试	1–10	2 核	4 GB	20 GB
小型生产	10–50	4 核	8 GB	100 GB SSD
中型生产	50–200	8 核	16 GB	200 GB SSD
大型部署	200+	16 核以上	32 GB 以上	独立数据库与存储

数据库与 Web 服务建议分离部署；文件附件建议使用独立磁盘或对象存储，并纳入备份策略。

软件依赖

组件	建议版本	说明
PostgreSQL	14 及以上	生产建议 16
NaviServer	4.99.5 及以上	也可使用与版本匹配的 AOLserver
Tcl	8.6	需包含常用扩展
Docker / Compose	24+ / v2	容器化部署时使用
Nginx	1.24+	反向代理、TLS 与静态缓存

数据库连接数需要根据并发用户数与 NaviServer 线程池调整。默认配置适合小规模部署，扩容前请压测。

网络与域名

• 通过 HTTPS 对外提供服务，证书可使用 ACME 自动签发；
• 反向代理需正确传递 Host、X-Forwarded-For 与 X-Forwarded-Proto；
• 如果使用 CDN，确认登录与上传接口不被缓存；
• 邮件出站需配置 SPF、DKIM，避免通知邮件进入垃圾箱。

中文环境

中文站点需要关注三件事：

1. 数据库编码：初始化时使用 UTF8，排序规则建议 zh_CN.UTF-8 或 C.UTF-8；
2. 站点语言：在站点参数中设置默认语言为简体中文，并安装中文消息目录；
3. 字体与导出：PDF 导出需要安装中文字体，否则会出现方框字。

-- 确认数据库编码
SELECT datname, pg_encoding_to_char(encoding) AS encoding, datcollate
FROM pg_database
WHERE datname = 'projectopen';

浏览器支持

支持最近两个主要版本的 Chrome、Edge、Firefox 与 Safari。IE 及旧版 Edge 不在支持范围内。

上线前检查

• 数据库已配置每日备份并完成一次恢复演练；
• 默认管理员口令已修改，测试账号已清理；
• HTTPS 证书有效，HTTP 自动跳转；
• 邮件发送测试通过；
• 日志目录有轮转策略；
• 监控覆盖进程、端口、磁盘与数据库连接数。