本教學只適用於v2.x以上版本。
網絡上有很多架設Mastodon的教學,但大部份都是1.x時期的版本,偏偏到了2.x版本後很多東西都已經不適用了,還是重新寫一篇吧。
SMTP,Swap等設定請參考以下網址,本文章只提供最基本的Mastodon架設教學:
https://github.com/ummjackson/mastodon-guide/blob/master/up-and-running.md
- 安裝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
- 複製以下設定檔內容並修改
需要修改的部份有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
- 回到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
- 回到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就好。
- 修改docker-compose.yml,Uncomment 所有volumes的部份,否則database的資料有可能會因為重啟等因素消失
Setup完畢後,最後只需要運行
docker compose up -d
起動所有的Container,稍侯片刻即可。
理論上用Docker架設Mastodon只要設定無誤就能正常運作,但不排除還會有其他問題,歡迎各位詢問或分享經驗。