68
docs/site-posts/04-deployment.md
Normal file
68
docs/site-posts/04-deployment.md
Normal 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。
|
||||
Reference in New Issue
Block a user