WriteFreely 是一个为写作者打造的极简发布平台:干净、专注写作,可用来开个人博客、在组织内分享知识,或围绕共同写作建立社区。它以静态二进制部署,内置 SQLite 也支持 MySQL/MariaDB,并通过 ActivityPub 接入联邦宇宙,能和 Plume 等其他 ActivityPub 软件互通。
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/writefreely/writefreely |
| 官方网站 | https://writefreely.org |
| 开源协议 | AGPL-3.0 |
| 主要语言 | Go(约 65.5%) |
| Star 数 | 约 5.3k |
| 数据库 | SQLite(内置)/ MySQL / MariaDB |
特性:无干扰的自动保存编辑器、可与其他 ActivityPub 社区互联、用 hashtag 分类文章、把普通文章 pin 成静态页、草稿、从一个账号发布到多个博客;界面本地化 20+ 语言,对非拉丁与 RTL 语言友好;默认私密,最小化数据收集。
二、官方图片
WriteFreely 阅读器视图截图(pen.writefree.ly 实例):

WriteFreely 官方 Logo:
三、环境要求
- 任意 Go 支持的平台与架构(Linux x86/ARM、macOS、Windows)。
- 数据库:默认内置 SQLite,零配置;或准备 MySQL/MariaDB。
- 反向代理:前面套 Nginx/Caddy 终止 TLS(生产环境)。
- 包管理器:Arch 用户可从 AUR 安装,Nanos 也有仓库。
四、完整部署步骤
1. 下载预编译二进制
到 GitHub Releases 页面 https://github.com/writefreely/writefreely/releases/ 下载对应平台的压缩包,解压:
tar -xzf writefreely.X.Y.Z.linux-amd64.tar.gz
cd writefreely
2. 初始化配置
WriteFreely 首次启动会引导配置。也可参考官方安装指南 https://writefreely.org/start 。选择内置 SQLite 可跳过外部数据库配置,直接生成初始配置文件。
3. 运行
./writefreely
默认监听对应端口,浏览器打开即可访问。生产环境建议用 systemd 托管,并在前面配置 HTTPS 反向代理。
4. Docker 部署
官方提供 Docker 镜像(ghcr.io/writefreely/writefreely),完整 Docker 指南见 https://writefreely.org/docs/latest/admin/docker 。
5. 创建管理员
首次访问 Web 界面后,按引导创建管理员账号,即可进入写作后台。
五、使用方法
写作
WriteFreely 内置自动保存编辑器,写作时无干扰;发布后文章排版居中、易读。支持 hashtag 给文章分类。
组织文章
- 把普通文章 pin 到博客顶部变成静态页;
- 创建草稿,择期发布;
- 一个账号可开多个博客,用于不同笔名或用途。
联邦宇宙(ActivityPub)
实例可与其他 WriteFreely、Plume 或任意 ActivityPub 软件互联,文章会同步到 Fediverse。OAuth 2.0 支持从现有平台邀请成员加入。
国际化
博客元素本地化 20+ 语言,一等支持非拉丁与 RTL(从右到左)书写。
托管服务
如果不想自己维护,官方托管服务 Write.as(https://write.as/writefreely)提供托管安装、备份、升级与维护。
六、常见问题 FAQ
1. 一定要用 MySQL 吗? 不用。WriteFreely 内置 SQLite,开箱即用;需要更大规模时再切到 MySQL/MariaDB。
2. 如何接入联邦宇宙? WriteFreely 原生支持 ActivityPub,实例配置好后即可与其他 ActivityPub 平台(Mastodon、Pleroma、Plume)互通,文章会同步到 Fediverse。
3. 可以一个人开多个博客吗? 可以。一个账号能创建多个博客,用于不同笔名或主题,且不会公开这些博客之间的关联。
4. 如何把文章变成静态页? 在文章设置里把它 pin 到博客,普通文章即可作为静态页面使用。
5. 支持哪些语言? 博客界面已本地化 20+ 语言,并且对中文、阿拉伯语等非拉丁/RTL 语言有一等支持。
6. 不想自己维护怎么办? 用官方托管服务 Write.as,由团队负责安装、备份、升级与维护,同时资助开源开发。
七、跳转链接
- GitHub 仓库:https://github.com/writefreely/writefreely
- 官方网站:https://writefreely.org
- 安装指南:https://writefreely.org/start
- 官方文档:https://writefreely.org/docs
- Docker 指南:https://writefreely.org/docs/latest/admin/docker