本教學只適用於v2.x以上版本。

網絡上有很多架設Mastodon的教學,但大部份都是1.x時期的版本,偏偏到了2.x版本後很多東西都已經不適用了,還是重新寫一篇吧。

SMTP,Swap等設定請參考以下網址,本文章只提供最基本的Mastodon架設教學:
https://github.com/ummjackson/mastodon-guide/blob/master/up-and-running.md

  1. 安裝Docker及Docker Compose
sudo apt-get install docker.io
sudo apt-get install pip
pip install docker-compose

2.安裝Nginx(作者不建議使用Apache)

apt-get install nginx

3.安裝Certbot(Mastodon 2.x 版本後強制要求使用SSL)

sudo add-apt-repository ppa:certbot/certbot
sudo apt-get update
sudo apt-get install certbot

4.下載Mastodon到你的伺服器上

git clone https://github.com/tootsuite/mastodon.git

5.複製Mastodon設定檔範例:

cp .env.production.sample .env.production

5.在Nginx上新增Mastdon網站的設定檔

vi /etc/nginx/sites-enabled/example.com.conf
  1. 複製以下設定檔內容並修改
    需要修改的部份有root, server_name以及ssl_certificate和ssl_certificate_key。
    請將root改成你的mastodon資料夾裡的public資料夾,server_name為網站域名,ssl_certificate和ssl_certificate_key域名的部份同樣改成你的網站域名。
map $http_upgrade $connection_upgrade {
  default upgrade;
  ''      close;
}

server {
  listen 80;
  listen [::]:80;
  server_name example.com;
  root /home/mastodon/public;
  # Useful for Let's Encrypt
  location /.well-known/acme-challenge/ { allow all; }
  location / { return 301 https://$host$request_uri; }
}

server {
  listen 443 ssl http2;
  listen [::]:443 ssl http2;
  server_name example.com;

  ssl_protocols TLSv1.2;
  ssl_ciphers HIGH:!MEDIUM:!LOW:!aNULL:!NULL:!SHA;
  ssl_prefer_server_ciphers on;
  ssl_session_cache shared:SSL:10m;

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

  keepalive_timeout    70;
  sendfile             on;
  client_max_body_size 0;

  root /home/mastodon/public;

  gzip on;
  gzip_disable "msie6";
  gzip_vary on;
  gzip_proxied any;
  gzip_comp_level 6;
  gzip_buffers 16 8k;
  gzip_http_version 1.1;
  gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

  add_header Strict-Transport-Security "max-age=31536000";

  location / {
    try_files $uri @proxy;
  }

  location ~ ^/(emoji|packs|system/accounts/avatars|system/media_attachments/files) {
    add_header Cache-Control "public, max-age=31536000, immutable";
    try_files $uri @proxy;
  }
  
  location /sw.js {
    add_header Cache-Control "public, max-age=0";
    try_files $uri @proxy;
  }

  location @proxy {
    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 https;
    proxy_set_header Proxy "";
    proxy_pass_header Server;

    proxy_pass http://127.0.0.1:3000;
    proxy_buffering off;
    proxy_redirect off;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;

    tcp_nodelay on;
  }

  location /api/v1/streaming {
    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 https;
    proxy_set_header Proxy "";

    proxy_pass http://127.0.0.1:4000;
    proxy_buffering off;
    proxy_redirect off;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;

    tcp_nodelay on;
  }

  error_page 500 501 502 503 504 /500.html;
}

7.重啟Nginx

sudo service nginx restart

8.利用Certbot產生你的網站SSL證書:
certbot -d example.com

  1. 回到Mastodon資料夾,修改.env.production
LOCAL_DOMAIN=example.com #修改為你的網站域名
SAFETY_ASSURED=1 
SECRET_KEY_BASE=  
OTP_SECRET= #

運行以下指令兩次,將產生的兩段Key分別填入SECRET_KEY_BASE及OTP_SECRET兩個位置

docker-compose run --rm web rake secret
  1. 回到Mastodon資料夾,修改public資料夾權限後運行Setup指令
chown -R 991:991 public
docker-compose run --rm web rake mastodon:setup

這個版本的Setup不能幫你修改設定檔,對應的部份仍需在.env.production進行設定。
運行自動設定的原因是它可以幫你設定好Database並編譯網站所需的檔案,
除了"Do you want to send test email now"外全部填y就好。

  1. 修改docker-compose.yml,Uncomment 所有volumes的部份,否則database的資料有可能會因為重啟等因素消失

Setup完畢後,最後只需要運行

docker compose up -d

起動所有的Container,稍侯片刻即可。
理論上用Docker架設Mastodon只要設定無誤就能正常運作,但不排除還會有其他問題,歡迎各位詢問或分享經驗。