Mastodon不能用系统包管理器安装，因其依赖PostgreSQL、Redis、Ruby、Node.js和Nginx等多组件协同，版本要求严格（如Ruby≥3.1、PostgreSQL≥12），且官方仅支持源码部署；系统仓库无预编译包，强行apt/yum安装会失败。
Mastodon 不是“一键安装就能跑”的服务，它依赖 PostgreSQL、Redis、Ruby、Node.js 和 Nginx 多组件协同，且官方不提供 .deb/.rpm 包。直接用包管理器装 apt install mastodon 或 yum install mastodon 会失败——根本不存在这个包。
为什么不能用系统包管理器安装 Mastodon
官方明确要求从源码部署（git clone https://github.com/mastodon/mastodon），原因有三：
- Mastodon 版本迭代快，发行版仓库滞后严重，Ubuntu/Debian 官方源中甚至从未收录过 Mastodon 包
- 其 Ruby on Rails 后端强依赖特定 gem 版本（如
rails 7.1.x、bootsnap 1.16+），系统 Ruby 环境无法满足 - 数据库迁移（
bundle exec rails db:migrate）、前端构建（npm run build）等步骤必须在部署时动态执行，无法预编译进二进制包
必须手动安装的 5 个核心依赖
缺一不可，顺序不能乱：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- PostgreSQL ≥ 12：用
sudo apt install postgresql-14 postgresql-contrib-14（Ubuntu 22.04+）或sudo dnf install postgresql-server（RHEL/CentOS Stream 9），再运行postgresql-setup initdb - Redis ≥ 6.2：Ubuntu 用
sudo apt install redis-server；RHEL 需启用 EPEL 后sudo dnf install redis - Ruby ≥ 3.1：禁止用系统自带
ruby（通常为 2.7），必须用rbenv或ruby-install管理版本，例如：rbenv install 3.2.4 && rbenv global 3.2.4 - Node.js ≥ 18：推荐用
nodesource源安装，避免npm权限问题：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt install -y nodejs - Nginx：仅作反向代理，不处理 Ruby 应用逻辑，配置中必须禁用
fastcgi_pass，改用proxy_pass http://127.0.0.1:3000
常见失败点：.env.production 配置陷阱
这个文件决定 Mastodon 是否能连上数据库、发邮件、走 HTTPS，90% 的启动失败源于此处：
-
DB_HOST=必须填localhost或127.0.0.1，填postgres（Docker 常见写法）在裸机上会报could not translate host name "postgres" to address -
REDIS_URL=redis://127.0.0.1:6379—— 不要加/0或/1，Mastodon 默认用 DB 0，加了反而连不上 -
LOCAL_DOMAIN=必须和你 Nginx 的server_name完全一致（包括 www 前缀），否则 WebFinger 查询失败，用户无法被外部实例发现 -
SMTP_FROM_ADDRESS=必须是合法邮箱格式（如notifications@yourdomain.tld），否则注册邮件发不出，且不会报错，只静默丢弃
启动后打不开页面？先查这三处日志
别急着重装，80% 是服务没真正起来：
- Web 进程日志：
tail -f /home/mastodon/live/log/production.log，看是否有FATAL或PG::ConnectionBad - Sidekiq 日志：
tail -f /home/mastodon/live/log/sidekiq.log，若显示Cannot connect to Redis，说明 Redis 未启动或端口被防火墙拦 - Nginx 错误日志：
sudo tail -f /var/log/nginx/error.log，典型错误是connect() failed (111: Connection refused) while connecting to upstream，意味着 Puma 进程根本没监听3000端口
实际部署中最容易被忽略的是 PostgreSQL 用户权限和 SELinux（RHEL/CentOS）。PostgreSQL 默认禁用密码登录，需手动编辑 /etc/postgresql/*/main/pg_hba.conf 加入 host all all 127.0.0.1/32 md5 并重载；而 SELinux 会阻止 Nginx 连接本地 socket，必须执行 sudo setsebool -P httpd_can_network_connect 1。这两处不处理，服务永远卡在“502 Bad Gateway”。
