stagas/textlog · 上手攻略
- 仓库：stagas/textlog
- 链接：https://github.com/stagas/textlog
- 分类：trending
- 作者：Tom
- 更新：2026-08-13
这是什么
textlog（textlog.cc）是一个极简去中心化微博客平台，核心设计理念是"发短文、关注人、加入对话"，每条笔记限制 280 字符，没有任何点赞/转发/算法推荐的干扰机制。平台基于 Bun + SQLite 开发，代码开源（AGPLv3），支持自托管，适合想要一个干净、无算法干扰的社交空间的用户。
Stars 64，周增 +14，是近期 Trending 上值得关注的小众社交平台项目。
解决什么问题
- 厌倦了 Twitter/X 的算法推荐和信息茧房，想要纯粹的文字社交
- 想搭建一个无追踪、无广告、无算法的私人或小众社区
- 想要一个 280 字符限制的简洁创作环境，减少"发长文"的心理压力
- 需要一个可导数据的去中心化平台，避免被单一平台绑定
快速安装
方式一：直接访问线上实例
无需安装，访问 textlog.cc 注册即可使用。
方式二：本地自托管
前置要求：Bun（≥ 1.0）
# 1. Clone 仓库
git clone https://github.com/stagas/textlog.git
cd textlog
# 2. 安装依赖
bun install
# 3. 配置环境变量
cp .env.example .env
# 编辑 .env，设置 APP_NAME 和 APP_URL
# 4. 启动开发服务器
bun run dev
# 打开 http://localhost:3000
# 5. 生产环境检查
bun run check
关键环境变量（.env）
APP_NAME=MyTextLog # 实例名称（用于 cookie、header 等）
APP_URL=https://mylog.cc # 公开访问 URL
EMAIL_PROVIDER=resend # 邮件发送：resend | sendgrid | google
RESEND_API_KEY=re_xxxx # Resend API Key（发注册/重置邮件用）
生产部署（可选）
生产启动时会自动生成每日公开数据快照 public/dump.zip，包含所有公开用户、笔记、关注关系（不含邮箱/密码等隐私数据），可供研究者下载。
核心用法
1. 发短文
注册后直接写，每条最多 280 字符，支持 @提及、#话题标签。
2. 关注人与话题
在用户主页或话题页面点击关注，类似 Twitter 的 follow 机制。
3. 加入对话
回复别人的笔记，使用 @username 进行互动，形成讨论链。
4. 导出/删除个人数据
平台提供数据导出（/dump.zip）和账户删除功能，用户可随时 complete 自己的数据主权。
5. 自托管定制
通过 instance.config.ts 配置文件可设置：
- 运营者联系方式
- 管理员邮箱
- 隐私政策链接
- 可选捐赠/社交/移动端 App 链接
典型适用场景
| 场景 | 适合程度 | 说明 |
|---|---|---|
| 搭建私人/小众文字社区 | ⭐⭐⭐⭐⭐ | 完全自控，无算法，推荐搭建独立博客圈 |
| 寻找 Twitter 替代品 | ⭐⭐⭐ | 规模尚小，内容生态不丰富 |
| 学习 Bun + SQLite 全栈开发 | ⭐⭐⭐ | 源码清晰，适合参考 |
| 学术研究社交网络 | ⭐⭐⭐ | 公开 dump.zip 可供分析 |
技术架构
| 技术栈 | 说明 |
|---|---|
| Bun | JavaScript 运行时 + 包管理 + 打包工具 |
| SQLite | 轻量级数据库，支持高并发读写 |
| AGPLv3 | 开源协议，商业使用需开源修改 |
架构非常简洁，适合作为小型社交应用的学习参考。
坑与注意
- 生态规模小：textlog.cc 目前用户量不大，内容丰富度有限，更适合尝鲜或自建。
- Bun 依赖：不支持 Node.js 原生运行，需安装 Bun（大多数 Linux/macOS 可直接用
curl -fsSL https://bun.sh/install | bash）。 - 邮件服务需额外配置：
.env中邮件 provider 必须配置，否则用户注册、重置密码等流程无法工作。 - AGPL3 协议：若基于此开发并提供服务，需开源你的修改。
- 自托管实例间不互通：目前各 textlog 实例之间没有 ActivityPub 等去中心化协议联通，不能跨实例关注。
与同类对比
| 平台 | 字符限制 | 算法推荐 | 开源 | 自托管 | 适合人群 |
|---|---|---|---|---|---|
| Twitter/X | 280 | 有 | 否 | 否 | 普通用户 |
| Mastodon | 无 | 无 | 是 | 是 | 追求去中心化 |
| Bluesky | 300 | 无 | 是 | 部分 | AT 协议尝鲜者 |
| textlog | 280 | 无 | 是（AGPL3） | 是 | 极简主义者 |
| Nostr | 无 | 无 | 是 | 是 | 抗审查用户 |
textlog 的定位介于 Twitter 的简洁风格 和 Mastodon 的去中心化理念 之间——更轻量、更专注文字，没有媒体流和算法干扰。
一句话推荐结论
想搭建一个无广告、无算法、纯文字的微型社交空间？textlog 是目前最简洁的开源方案，用 Bun + SQLite 跑起来只需 5 分钟。