新增站务公告板块发帖素材与发布说明。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-08-03 17:39:27 +08:00
parent dd9e185847
commit 61b47363e9
5 changed files with 328 additions and 0 deletions

View File

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