热门搜索:
prologic/yarnd
prologic
Yarn.social 是一个去中心化的自托管社交媒体平台，以隐私优先为核心，无广告、无跟踪，用户完全掌控内容和数据，提供类 *** 的微博客功能及命令行与 Web 客户端支持。
1 次收藏下载次数: 0状态：社区镜像维护者：prologic仓库类型：镜像最近更新：7 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Yarn.social
概述和主要用途
Yarn.social 是一个自托管、类 *** 的去中心化微博客平台。无广告、无跟踪，内容和数据完全由用户掌控！
yarnd是 Yarn.social 节点后端服务器yarnc是yarndAPI 的命令行客户端，同时支持 Twtxt 协议交互
核心功能和特性
- 去中心化架构：无需依赖中心化服务，支持个人或组织自行部署节点（pod）
- 隐私优先设计：无广告、无用户行为跟踪，数据存储在用户自有服务器
- 多客户端支持：提供 Web 界面和命令行客户端（
yarnc），满足不同使用场景 - 媒体支持：集成媒体上传功能（需 FFmpeg 支持）
- 可定制配置：支持开放注册/个人资料、动态长度限制、缓存策略等精细化设置
- 容器化部署：提供 Docker 镜像和 Docker Compose/Swarm 配置，简化部署流程
使用场景和适用范围
- 个人用户搭建私有社交媒体平台，保护数据隐私
- 小型社区或组织部署内部交流网络
- 对现有社交媒体平台隐私政策不满，寻求替代方案的用户
- 技术爱好者构建去中心化网络生态
详细使用方法和配置说明
安装方式
预编译二进制文件（暂不推荐）
注意：在 Issue #250 解决前，建议优先使用 Docker 镜像或从源码构建。
可从 Releases 页面获取预编译二进制文件。
使用 Homebrew（macOS）
console# 添加 Homebrew 仓库 brew tap yarnsocial/yarn https://git.mills.io/yarnsocial/homebrew-yarn.git # 安装（包含 yarnd 服务器和 yarnc 客户端） brew install yarn
启动服务器：
consoleyarnd
运行命令行客户端：
consoleyarn
从源码构建（需 Go 开发环境）
- 克隆仓库：
consolegit clone https://git.mills.io/yarnsocial/yarn.git
-
安装依赖：
- Linux/macOS：
consolemake deps媒体上传功能需安装 FFmpeg 及其开发包（如
ffmpeg-dev），具体名称参考系统软件仓库。- FreeBSD：
console# 安装必要工具 pkg install gmake pkgconf # 安装依赖 gmake deps -
构建二进制文件：
- Linux/macOS：
make - FreeBSD：
gmake
- Linux/macOS：
基本使用
命令行客户端（yarnc）
- 登录节点：
$ ./yarn login INFO[0000] 使用配置文件: /Users/prologic/.twt.yaml 用户名:
- 查看时间线：
$ ./yarn timeline INFO[0000] 使用配置文件: /Users/prologic/.twt.yaml > prologic (50 分钟前) Hey @rosaelefanten 👋 很高兴看到你有 Twtxt 动态！看到了你的 [推文](https://twitter.com/koehr_in/status/1326914925348982784?s=20)（我猜是你的？）。之前从没听说过 `aria2c`！🤣 今日新发现 > dilbert (2 小时前) 愤怒的技术作家 ‣ https://dilbert.com/strip/2020-11-14
- 发布动态：
$ ./yarn post INFO[0000] 使用配置文件: /Users/prologic/.twt.yaml 测试 `yarn` 命令行客户端 INFO[0015] 发布动态中... INFO[0016] 发布成功
- 查看帮助：
consoleyarnc help
使用 Docker Compose 快速部署
- 准备
docker-compose.yml（官方镜像） - 启动服务：
consoledocker-compose up -d
- 访问 Web 界面：http://localhost:8000/
Web 应用启动
直接运行后端服务器 yarnd（默认禁用注册，需手动启用）：
console# 启用注册并启动 yarnd -R
核心配置选项
通过命令行参数或环境变量配置节点，关键选项如下：
| 参数 | 说明 | 默认值 |
|---|---|---|
-d, --data | 数据存储目录 | ./data |
-s, --store | 存储引擎路径 | bitcask://twtxt.db |
-R, --open-registrations | 启用用户注册 | 禁用 |
-O, --open-profiles | 开放用户个人资料访问 | 禁用 |
-L, --max-twt-length | 单条动态最大长度 | 288 |
-U, --max-upload-size | 媒体上传最大体积（字节） | *** (16MB) |
安全配置（必须设置）： 生成 64 位随机密钥（API 签名、Cookie 加密等）：
consolecat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 64 | head -n 1
通过环境变量设置：
bashexport API_SIGNING_KEY="生成的密钥" export COOKIE_SECRET="生成的密钥" export MAGICLINK_SECRET="生成的密钥"
生产环境部署（Docker Swarm）
- 确保集群已安装 Traefik 负载均衡器
- 使用官方
yarn.yamlStack 文件部署：
consoledocker stack deploy -c yarn.yml
贡献与支持
- 提交 Issue：报告错误/功能建议
- 代码贡献：提交 PR 至官方仓库，参考 贡献指南
- 开发者文档：dev.twtxt.net
许可证
采用 MIT 许可证
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull prologic/yarnd:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"