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