2.1 KiB
2.1 KiB
为什么是单文件部署
建议标题：为什么是单文件部署
建议标签：站务部署技术
建议操作：按需发布（给关心自建的人看）
姜十三论坛最硬核的卖点之一，是部署路径极短。
不是「理论上可以打包」，而是日常用法就是：
- 编译得到一个二进制
- 放到目录里运行
- 自动生成
app.ini - 浏览器注册，第一个账号即管理员
它解决什么问题
传统论坛方案常常落在两端：
- 很重：功能全，但部署与运维成本高
- 很碎：聊天工具 / 文档工具方便，却缺少「发帖—回复—沉淀」的社区节奏
小圈子真正需要的往往是中间态：
- 有论坛结构，讨论可追溯
- 界面清爽，用起来顺手
- 部署简单到一个人能搞定
- 数据清楚、备份好懂
单文件部署，就是为最后两点服务的。
具体意味着什么
| 能力 | 说明 |
|---|---|
| 单二进制 | 前端静态资源已内嵌，不必单独部署一套前端目录 |
| 内置 SQLite | 零外部数据库，数据落在本地目录 |
精简 app.ini |
主要管端口、数据目录、JWT 等进程级配置 |
| 后台热配置 | OIDC、邮件、存储、品牌等在管理后台修改，保存即生效 |
| 系统服务 | 内置 Linux systemd / Windows Service 安装与启停 |
| 跨平台 | Windows / Linux / macOS 均可编译与运行 |
备份也直观：数据目录里的数据库、上传文件、配置，结构清晰，拷贝即可留存。
配置怎么分工
| 改什么 | 去哪里 |
|---|---|
| HTTP 端口、数据目录、JWT | app.ini（修改后重启进程 / 服务） |
| 站点品牌、OIDC、邮件、对象存储、限流、敏感词 | 管理后台 → 系统设置 |
这样既保留「改文件就能控进程」的可控性，又避免把所有业务项都塞进配置文件。
一句话总结
姜十三论坛 = 小圈子该有的论坛能力 × 清新好用的界面 × 真正能单文件带走的部署方式。
源码与说明见项目仓库。许可证：MIT。