Loading...

文章背景图

WriteFreely:极简联邦宇宙博客平台部署与使用指南

2026-10-27
0
- 字
- 分钟
|

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 阅读器视图

WriteFreely 官方 Logo:

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
评论交流

文章目录