Lemmy 是一个由 Rust 编写、基于 ActivityPub 协议的联邦论坛程序，界面和使用逻辑类似 Reddit 或 Hacker News。与传统的中心化论坛不同，每个 Lemmy 实例都是独立站点，但用户可以关注联邦宇宙中其他实例的社区、帖子和评论，实现跨站互动。在自己的云服务器上部署 Lemmy，既能拥有数据主权，也能自定义社区规则和主题。部署过程涉及 PostgreSQL 数据库、后端 API、前端 UI、图片服务以及联邦调度组件，官方推荐使用 Docker Compose 进行统一编排，这样可以减少手动配置依赖的复杂度。
一、部署前的准备
在开始安装之前，需要准备一台可用的云服务器。最低配置建议为 1 核 1GB 内存，但如果计划承载较多用户或开启图片上传，建议使用 2 核 2GB 以上配置。操作系统推荐 Ubuntu 22.04 或 24.04，也可以使用 Debian 12。由于联邦协议要求实例具备 HTTPS 能力，必须准备一个域名，并将域名的 A 记录解析到云服务器公网 IP。域名解析生效后，再开放 80 和 443 端口，SSH 的 22 端口保持开启即可。
登录服务器后，先更新系统并安装一些基础工具。执行以下命令：
<code>apt update apt install -y curl git ufw certbot python3-certbot-nginx</code>
其中 certbot 会在后续申请 SSL 证书时使用，python3-certbot-nginx 是 Nginx 证书自动配置插件。如果系统已经预装了这些工具，可以跳过这一步。完成基础准备后，就可以进入 Docker 环境的安装。
二、安装 Docker 与 Docker Compose
Lemmy 官方提供的部署方案使用 Docker Compose 管理四个核心容器：lemmy 后端、lemmy-ui 前端、pictrs 图片服务和 postgres 数据库。因此需要先安装 Docker Engine 以及 Docker Compose 插件。Ubuntu 下可以通过 Docker 官方源安装，也可以使用系统自带的 docker.io 包。为了防止版本过旧影响 Lemmy 运行，建议使用官方安装脚本：
<code>curl -fsSL https://get.docker.com | sh</code>
安装完成后，启动 Docker 服务并设置开机自启：
<code>systemctl enable docker systemctl start docker</code>
为了在非 root 用户下直接使用 docker 命令，可以将当前用户加入 docker 组，然后重新登录使权限生效。如果不想频繁使用 sudo，这一步很有必要。
三、获取配置文件并创建目录结构
创建专门的目录用于存放 Lemmy 配置和数据。通常使用 /opt/lemmy 作为根目录，并在其中放置 docker-compose.yml 和 lemmy.hjson 两个核心文件。可以使用 git 克隆官方仓库获取示例文件，也可以直接用 curl 下载。官方仓库中的 docker-compose.yml 已经定义好了各服务之间的通信关系，只需要修改少量环境变量和绑定配置即可。
目录结构大致如下：
<code>/opt/lemmy ├── docker-compose.yml ├── lemmy.hjson ├── pictrs └── postgres</code>
其中 pictrs 目录用于保存上传的图片，postgres 目录用于持久化数据库文件。将这些目录提前创建好，可以避免容器首次启动时因权限不足而失败。
四、配置 lemmy.hjson 关键参数
lemmy.hjson 是 Lemmy 后端的主配置文件，使用 HJSON 格式编写。HJSON 兼容 JSON 语法，但允许写注释，非常适合人工维护。配置文件中最重要的参数包括 hostname、数据库连接信息、管理员账号、SMTP 邮件配置以及联邦开关。一个精简的配置示例如下：
<code>{
hostname: your.domain
bind: 0.0.0.0
port: 8536
database: {
host: postgres
port: 5432
user: lemmy
password: change_this_password
database: lemmy
}
admin: {
username: admin
password: change_admin_password
email: admin@your.domain
}
federation: {
enabled: true
}
pictrs: {
url: http://pictrs:8080
}
}</code>其中 hostname 必须填写实际使用的域名，不能填写 IP 地址，否则联邦签名校验会失败。数据库密码需要与 docker-compose.yml 中的 POSTGRES_PASSWORD 保持一致，否则后端无法连接数据库。admin 段用于首次启动时自动创建管理员账号，如果实例已有管理员账号，可以将其删除或留空。
| 参数 | 作用 | 示例 |
|---|---|---|
| hostname | 实例对外域名 | lemmy.ippipp.com |
| database.password | PostgreSQL 连接密码 | 与 compose 中一致 |
| admin.username | 初始管理员用户名 | admin |
| federation.enabled | 是否开启联邦功能 | true |
| pictrs.url | 图片服务容器地址 | http://pictrs:8080 |
如果不需要联邦功能，可以把 federation.enabled 设为 false，但这样实例就变成了完全独立的论坛，无法与其他实例互通。邮件配置用于注册验证、密码找回和通知发送，建议在正式上线前配置好 SMTP。
五、配置 docker-compose.yml
官方 docker-compose.yml 已经定义了 lemmy、lemmy-ui、pictrs 和 postgres 四个服务。需要修改的地方主要集中在 postgres 服务的 POSTGRES_PASSWORD 环境变量，以及 lemmy 服务挂载的配置文件路径。以下是一个简化版示例：
<code>services:
postgres:
image: postgres:16-alpine
environment:
- POSTGRES_USER=lemmy
- POSTGRES_PASSWORD=change_this_password
- POSTGRES_DB=lemmy
volumes:
- ./postgres:/var/lib/postgresql/data
restart: always
lemmy:
image: dessalines/lemmy:latest
volumes:
- ./lemmy.hjson:/lemmy.hjson
depends_on:
- postgres
- pictrs
restart: always
lemmy-ui:
image: dessalines/lemmy-ui:latest
environment:
- LEMMY_UI_LEMMY_INTERNAL_HOST=lemmy:8536
- LEMMY_UI_LEMMY_EXTERNAL_HOST=your.domain
depends_on:
- lemmy
restart: always
pictrs:
image: asonix/pictrs:latest
volumes:
- ./pictrs:/mnt
restart: always</code>保存后检查 lemmy.hjson 中 database.password 和 compose 文件中的 POSTGRES_PASSWORD 是否一致。两者不一致是最常见的启动失败原因。另一个容易忽略的地方是 lemmy-ui 的 LEMMY_UI_LEMMY_EXTERNAL_HOST，它必须与 lemmy.hjson 中的 hostname 完全一致。
六、配置 Nginx 反向代理并申请证书
Lemmy 后端默认监听 8536 端口，前端 UI 监听 1234 端口，图片服务监听 8080 端口。生产环境通常使用 Nginx 作为统一入口，将 80 和 443 端口的请求分别转发到对应服务。Nginx 还需要为 /api、/pictrs 等路径设置代理，并传递必要的请求头。一个可用的配置示例如下：
<code>server {
listen 80;
server_name your.domain;
location / {
proxy_pass http://127.0.0.1:1234;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /api {
proxy_pass http://127.0.0.1:8536;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /pictrs {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
}
}</code>将此配置写入 /etc/nginx/sites-available/lemmy 并创建软链接到 sites-enabled 后，运行 nginx -t 检查语法，再执行 systemctl reload nginx 使配置生效。接下来使用 certbot 申请 Let's Encrypt 证书：
<code>certbot --nginx -d your.domain</code>
证书申请成功后，certbot 会自动修改 Nginx 配置，将 HTTP 请求重定向到 HTTPS，并添加证书路径。后续证书会自动续期，无需手动干预。联邦协议要求实例必须以 HTTPS 提供服务，否则其他实例会拒绝建立信任关系。
七、启动服务并初始化管理员
在 /opt/lemmy 目录下执行 docker compose up -d 即可拉取镜像并启动所有服务。首次启动会下载 Lemmy 后端、前端、图片服务和 PostgreSQL 镜像，耗时取决于网络状况。启动后可以通过 docker compose logs -f lemmy 查看后端日志，确认没有数据库连接错误或配置语法错误。
如果 lemmy.hjson 中配置了 admin 段，首次启动时后端会自动创建管理员账号。访问 https://your.domain 应该能看到 Lemmy 的前端界面。使用配置的管理员账号登录后，可以创建第一个社区、设置站点名称和描述，并开始发布内容。如果界面无法打开，检查防火墙是否放行 80 和 443 端口，以及 Nginx 是否正常转发到 1234 端口。
八、联邦功能验证与调试
联邦是 Lemmy 的核心特性。要验证联邦是否正常，可以在本实例的搜索框中输入远程社区的全名，格式为 !社区名@远程域名，例如 !fediverse@lemmy.ml。如果远程实例在线且网络通畅，稍等片刻后社区信息就会出现在搜索结果中，关注后即可开始同步帖子。也可以从 Mastodon 侧搜索 Lemmy 用户，格式为 @用户名@你的域名，若能看到用户信息，说明联邦通信基本正常。
如果联邦功能失效，首先检查 HTTPS 证书是否有效、hostname 是否配置正确，以及 Nginx 是否正确代理了 /.well-known/webfinger、/inbox 和 /outbox 路径。可以用 curl 发送一个 ActivityPub 请求测试：
<code>curl -H 'Accept: application/activity+json' https://your.domain/u/admin</code>
如果返回的是 JSON-LD 格式的用户信息，说明后端联邦端点工作正常；如果返回 HTML 页面或 404，则需要检查 Nginx 的代理规则。联邦内容同步存在一定延迟，尤其是首次关注远程社区时，需要等待对方的投递队列处理完成。
九、常见问题与维护建议
数据库连接失败是最常见的问题，通常是因为 lemmy.hjson 中的密码与 docker-compose.yml 中的 POSTGRES_PASSWORD 不一致。遇到这种情况时，先停止所有容器，删除 postgres 数据目录并重新启动，让数据库重新初始化。图片上传失败则要检查 pictrs 容器是否健康运行，以及 Nginx 中 /pictrs 路径是否正确指向 8080 端口。
邮件发送功能需要在 lemmy.hjson 中配置 SMTP 服务器信息，否则用户注册后的邮箱验证和密码找回功能不可用。对于小型实例，建议定期备份 postgres 数据目录和 pictrs 图片目录，可以使用 cron 定时执行 tar 打包并同步到对象存储。升级 Lemmy 时，先备份配置文件，然后修改 docker-compose.yml 中的镜像版本标签，重新执行 docker compose up -d 即可完成升级。
性能方面，如果服务器内存较小，可以创建 swap 交换空间来缓解内存压力。图片服务默认限制上传大小为 10MB，可以在 pictrs 的环境变量中调整。对于访问量较大的实例，建议将 PostgreSQL 的 shared_buffers 调大，并将图片存储迁移到对象存储，以减少本机磁盘压力。完成这些优化后，一台稳定、可联邦的 Lemmy 论坛实例就部署完成了。