---
title: 从源代码安装
description: 创建你自己的 Mastodon 站点的教程。
menu:
  docs:
    weight: 20
    parent: admin
---

## 前提条件 {#pre-requisites}

* 一台运行 **Ubuntu 24.04** 或 **Debian 12** 的机器，你需要拥有root访问权限
* 一个用于 Mastodon 站点的**域名**（或子域名），例如 `example.com`
* 一个电子邮件发送服务或其他 **SMTP 服务器**

在以下示例中，我们将使用 `example.com` 作为域名。请记得在运行任何命令前将其替换为你自己的域名。

你将以 root 身份运行命令。如果你还不是 root 用户，请切换到 root：`sudo -i`

### 系统存储库 {#system-repositories}

首先确保已安装 curl、 wget、 gnupg、 apt-transport-https、 lsb-release 和 ca-certificates：

```bash
apt install -y curl wget gnupg apt-transport-https lsb-release ca-certificates
```

#### Node.js {#node-js}

```bash
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list
```

#### PostgreSQL {#postgresql}

```bash
wget -O /usr/share/keyrings/postgresql.asc https://www.postgresql.org/media/keys/ACCC4CF8.asc
echo "deb [signed-by=/usr/share/keyrings/postgresql.asc] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/postgresql.list
```

### 系统软件包 {#system-packages}

```bash
apt update
apt install -y \
  imagemagick ffmpeg libvips-tools libpq-dev libxml2-dev libxslt1-dev file git-core \
  g++ libprotobuf-dev protobuf-compiler pkg-config gcc autoconf \
  bison build-essential libssl-dev libyaml-dev libreadline6-dev \
  zlib1g-dev libncurses5-dev libffi-dev libgdbm-dev \
  nginx nodejs redis-server redis-tools postgresql postgresql-contrib \
  certbot python3-certbot-nginx libidn11-dev libicu-dev libjemalloc-dev
```

#### Yarn {#yarn}

启用`corepack`，以便自动安装正确版本的`yarn`：

```bash
corepack enable
```

### 创建 `mastodon` 用户 {#creating-the-mastodon-user}

执行以下命令，创建用于运行 Mastodon 的用户：

```bash
adduser --disabled-password mastodon
```

## 配置 {#setup}

### 配置 PostgreSQL {#setting-up-postgresql}

#### 性能配置（可选） {#performance-configuration-optional}

为获得最佳性能，你可以使用 [pgTune](https://pgtune.leopard.in.ua/#/) 生成适当的配置，并在使用 `systemctl restart postgresql` 重启 PostgreSQL 之前编辑 `/etc/postgresql/17/main/postgresql.conf` 中的值。

#### 创建用户 {#creating-a-user}

你需要创建一个供 Mastodon 使用的 PostgreSQL 用户。在简单配置中，最简单的方法是使用 "ident" 认证，即 PostgreSQL 用户没有单独的密码，可以由具有相同用户名的 Linux 用户使用。

打开命令行：

```bash
sudo -u postgres psql
```

在命令行中执行：

```sql
CREATE USER mastodon CREATEDB;
\q
```

完成！

### 设置 Mastodon {#setting-up-mastodon}

现在是下载 Mastodon 代码的时候了。切换到 mastodon 用户：

```bash
su - mastodon
```

#### 检出代码 {#checking-out-the-code}

使用 git 下载 Mastodon 的最新稳定版本：

```bash
git clone https://github.com/mastodon/mastodon.git live && cd live
git checkout $(git tag -l | grep '^v[0-9.]*$' | sort -V | tail -n 1)
```

#### 安装 Ruby {#installing-ruby}

我们将使用 rbenv 来管理 Ruby 版本，因为它简化了获取正确版本和在新版本可用时进行更新的过程。
安装 rbenv 和 ruby-build：

```bash
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
exec bash
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
```

完成这些后，我们可以安装正确的Ruby版本：

```bash
RUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install
```

#### 安装最后的依赖项 {#installing-the-last-dependencies}

现在安装 Ruby 和 JavaScript 依赖项：

```bash
bundle config deployment 'true'
bundle config without 'development test'
bundle install -j$(getconf _NPROCESSORS_ONLN)
yarn install
```

{{< hint style="info" >}}
仅在首次安装依赖项时需要执行两个 `bundle config` 命令。如果你之后要更新或重新安装依赖项，只需执行 `bundle install` 就足够了。
{{< /hint >}}

#### 生成配置 {#generating-a-configuration}

运行交互式设置向导：

```bash
RAILS_ENV=production bin/rails mastodon:setup
```

这将：

* 创建一个配置文件
* 运行资源预编译
* 创建数据库架构

配置文件保存为 `.env.production`。你可以查看并按照喜好编辑它。请参考[配置文档]({{< relref "config" >}})。

现在你已完成 mastodon 用户的操作，切回 root 用户：

```bash
exit
```

### 获取SSL证书 {#acquiring-a-ssl-certificate}

我们将使用 Let's Encrypt 获取免费的 SSL 证书：

```bash
certbot certonly --nginx -d example.com
```

这将获取证书并将其保存在 `/etc/letsencrypt/live/example.com/` 目录下。

### 设置nginx {#setting-up-nginx}

从 Mastodon 目录复制 nginx 的配置模板：

```bash
cp /home/mastodon/live/dist/nginx.conf /etc/nginx/sites-available/mastodon
ln -s /etc/nginx/sites-available/mastodon /etc/nginx/sites-enabled/mastodon
rm /etc/nginx/sites-enabled/default
```

然后编辑 `/etc/nginx/sites-available/mastodon` 以

1. 将 `example.com` 替换为你自己的域名
2. 取消注释 `ssl_certificate` 和 `ssl_certificate_key`（如果你使用自己的证书，请忽略此步骤）：

    ```
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;;
    ```

3. 进行你可能需要的任何其他调整。

允许其他用户遍历 mastodon 用户的主目录，以便 nginx 的 `www-data` 用户可以访问资源文件：

```bash
chmod o+x /home/mastodon
```

重启 nginx 使更改生效：

```bash
systemctl restart nginx
```

此时，你应该能够在浏览器中访问你的域名，看到大象撞击电脑屏幕的错误页面。这是因为我们还没有启动 Mastodon 进程。

### 设置 systemd 服务 {#setting-up-systemd-services}

从 Mastodon 目录复制 systemd 服务模板：

```sh
cp /home/mastodon/live/dist/mastodon-*.service /etc/systemd/system/
```

如果你修改了默认设置，请检查用户名和路径是否正确：

```sh
$EDITOR /etc/systemd/system/mastodon-*.service
```

最后，启动并启用新的 systemd 服务：

```sh
systemctl daemon-reload
systemctl enable --now mastodon-web mastodon-sidekiq mastodon-streaming
```

Mastodon 服务现在将在开机时自动启动。

{{< hint style="success" >}}
**太好了！以上就是安装 Mastodon 的全部步骤。现在你可以在浏览器中访问你的站点了！**
{{< /hint >}}

{{< translation-status-zh-cn raw_title="Installing from source" raw_link="/admin/install/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}