RewrZ

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 17 Open GitHub ↗

RewrZ Project - 一个中庸的个人博客系统项目。基于 FastAPI 构建，轻量级设计，可在 512MB 内存服务器上流畅运行，注重隐私保护和个性化定制。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RewrZ

> **Rewrite + Philosophyz = RewrZ**
> 用哲学的态度，重写最后一次。

一个面向个人创作者的博客系统：**FastAPI + HTMX + SQLite**，强调轻量部署、可控安全和长期可维护。
当前版本：**3.0 正式版**。

## 前端资源构建
- 项目当前使用本地 Tailwind 编译产物，不再依赖前台运行时 CDN。
- 首次参与前端样式开发前，请先执行：
```bash
npm install
npm run build:css
```
- 修改 `rewrz/templates/`、`rewrz/static/js/` 中涉及 Tailwind 类名的内容后，需重新执行：
```bash
npm run build:css
```
- 开发时可使用监听模式：
```bash
npm run watch:css
```
- 仓库会提交编译后的 CSS 产物，生产部署默认不要求安装 Node。

## 重构说明
本项目正在持续重构与收敛，部分功能仍在完善中。
如果你在使用中遇到问题，欢迎提交 issue，一起把它打磨成一个真正稳定可用的个人博客系统。

我曾经一度放下这个项目，回到 WordPress 系统，只想把精力留给写作本身。
但现实是，随着主流博客系统版本、环境和依赖持续升级，维护成本并没有真正消失，部署门槛与维护成本也在抬升。
如果独立博客最终只剩下“持续升级基础设施”这一条路，那么“写作本身”反而会被挤到次要位置。
另外还有一个现实问题：**后台登录入口长期暴露在自动化攻击流量下**，时间被大量消耗在“防守”上。
当写作系统本身变成一场持续对抗，技术就开始反客为主。
于是我决定把这个旧项目重新捡起来，不追求大而全，只做真正会长期使用的能力。
这不是一次短期折腾，而是一次“最后一次认真重构个人博客系统”的选择。

## 项目初心
这个项目不是为了“再造一个更复杂的 CMS”，而是为了回到写作本身。

多年使用主流博客系统后，最深的体感不是“功能不够”，而是两种极端：
- 要么功能过重、依赖过多、维护成本越来越高；
- 要么过于极简，关键能力还得自己拼装。

RewrZ 的核心态度是：
- 以写作与表达为中心，而不是被工具绑架；
- 以中庸收敛替代无限堆叠；
- 以长期可维护替代短期炫技。

### 作者寄语
> 只要你用过WordPress，你就知道，你的后台登录页面，就是互联网上最繁忙的公共厕所。来自全球各个角落的IP，每分每秒都在尝试爆破你的密码。这是个不争的事实。因为WordPress太出名了，它占据了全球网站的半壁江山，所以成了所有自动化攻击脚本的默认目标。黑客们写的脚本，就是对着WordPress的wp-login.php这个裤裆猛踹。
> 这个项目的初衷，是把时间从“对抗噪音”拿回来，重新用于写作和表达。
> 对我来说，RewrZ 是“最后一次个人网站项目”的重构尝试。
>
> 不再无限开新坑，专注维护这一个系统，让它长期可用、可控、可持续。

## 项目定位
RewrZ 不是“大而全 CMS”，也不是“纯静态生成器”，而是偏向个人站长的中间路线：
- 后端完整可控（账号、评论、媒体、导入导出、后台管理）
- 资源占用相对可控（小体量服务可运行）
- 尽量减少外部运行时依赖（前端以 HTMX + 模板为主）

## 与主流博客系统对比

先说结论：RewrZ 的优势不在“生态最大”，而在“**更可控、更收敛、更适合长期自维护**”。

| 对比维度 | RewrZ 的优势 | WordPress/Ghost/Hexo-Hugo 的典型优势 |
|---|---|---|
| 安全基线（默认） | 后台路径隐藏、CSRF、上传与导入限制等内建能力更集中，减少“先装一堆安全插件”步骤 | 生态成熟，但常需通过插件/额外组件组合安全能力 |
| 内容模型治理 | `post_type` 强收敛（仅 `post/page`），`formats` 语义清晰，长期演进更不易漂移 | 模型更自由，但多人或长期演进时更容易出现历史包袱 |
| 二次开发成本 | API/CRUD/Model 分层直改，业务逻辑集中，适合“自己就是维护者”的团队/个人 | 生态方案多，起步快，但深度定制时可能受插件边界或框架约束 |
| 小体量部署 | 依赖链相对短，适合个人站长控制资源和复杂度 | 静态方案性能极强；WP/Ghost 在成熟运维下也可稳定，但整体体系更重 |
| 迁移与数据主权 | 内置 RewrZ/WordPress 导入导出，便于把内容掌握在自己手里 | 各有方案，但迁移路径和格式一致性依赖具体生态工具 |

### 什么时候优先选 RewrZ
- 你想要“可持续维护的个人系统”，而不是“功能市场型平台”。
- 你更看重架构可控和长期一致性，而不是插件数量。
- 你愿意在前期投入少量开发时间，换后期更低的演进摩擦。

### 什么时候不建议选 RewrZ
- 你需要现成的超大插件生态和大量第三方模板市场。
- 你希望零开发介入、开箱即用地覆盖非常复杂的业务场景。

## 文档导航
- 文档中心：[`docs/INDEX.md`](docs/INDEX.md)
- 使用文档：[`docs/guides/USAGE.md`](docs/guides/USAGE.md)
- 开发文档：[`docs/guides/DEVELOPMENT.md`](docs/guides/DEVELOPMENT.md)
- APP 开发指南：[`docs/architecture/API_APP.md`](docs/architecture/API_APP.md)
- 发布包生成：[`docs/operations/RELEASE.md`](docs/operations/RELEASE.md)
- 路线图（含 AI / 联邦化方向）：[`docs/planning/ROADMAP.md`](docs/planning/ROADMAP.md)

## 快速开始
```powershell
git clone https://github.com/RewrZ/RewrZ.git
cd RewrZ
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
.\.venv\Scripts\python.exe -m uvicorn rewrz.main:app --host 127.0.0.1 --port 8001 --reload
```

首次启动请访问安装向导：`/installer`

## 生成干净发布包

如需为 GitHub Release 生成 `3.0` 正式版干净 ZIP 发布包，可直接执行：

```powershell
.\scripts\build_release_package.ps1 -Version 3.0
```

生成结果默认输出到 `release/`，详细说明见：

- [`docs/operations/RELEASE.md`](docs/operations/RELEASE.md)

## 界面预览

### 首页
![首页预览](https://raw.githubusercontent.com/rewrz/RewrZ/master/preview/首页.jpg)

### 微博页
![微博页预览](https://raw.githubusercontent.com/rewrz/RewrZ/master/preview/微博页.jpg)

### 后台登录页
![后台管理-登录页预览](https://raw.githubusercontent.com/rewrz/RewrZ/master/preview/后台管理-登录页.jpg)

### 后台管理（仪表盘）
![后台管理-仪表盘预览](https://raw.githubusercontent.com/rewrz/RewrZ/master/preview/后台管理-仪表盘.jpg)

## 开源协议
本项目使用 **AGPL-3.0**。

RewrZ

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README