小球飞象站建站过程及相关笔记,Docker建站,建站时间2021年11月底

Mantyke
最后编辑于 April 2022 Mastodon/长毛象

原链接:Mastodon | 小球飞象建站笔记
标建站方式和建站时间是因为建站过程中发现已有的部分教程,因为时间间隔较久,有部分步骤需要稍作调整,供后来站长一并参考。

踩在2021年的尾巴上也当了站长,在魔改前总之先记一下建站过程。


参考教程和鸣谢

小球飞象的搭建总体以Docker快速部署Mastodon教程为基础,参考pullopen的部分配置,象友Roelxy纯之手把手教学,前后大约花费16小时,重装VPS 3次。

两位象友都是搭博客过程中认识的,都给予了非常重要的帮助,非常感谢!


搭建过程

购买VPS

之前看建站教程,大部分推荐Vultr,但被象友告知,Vultr的5刀套餐不怎么好用,只有1G的内存和25G的SSD,内存太小需要开虚拟内存,硬盘太小也很容易装满,再升级就是每月10刀,又有点贵。不如换Contabo的7刀套餐,8G内存、200G SSD和1个快照,建完站还能搭点别的服务。

于是等到黑五,购买前先把价格修改成欧元,黑五期间免设置费,一次购买12个月免1个月,同时美国机房免附加费用。最后买了4.99欧/月的套餐,机房选了西雅图,后面的全部默认,用Visa付款,最终费用为54.88欧/年,大概是400人民币?

Contabo人工审核比较严格,一旦审核不通过则需要真实身份信息,所以要以真实IP购买,同时填写身份地址信息时不要太扯(。

我自己的审核非常快,付款后不到10分钟就发来了VPS信息邮件,这封邮件里有Contabo账号和VPS IP、密码等信息,收到后最好保存起来。


Termius

Termius是个终端,可以远程连接服务器,多平台通用,挺好看。

下载后先换个快捷键,Termius默认复制粘贴快捷键是Ctrl+Shift+C/Ctrl+Shift+V,为了方便起见改成熟悉的Ctrl+CCtrl+V。然后点New host,在adress部分输入Cantabo提供的IP address,双击新增的host,输入账号密码。

注:西风提醒我说终端不用Ctrl+C作复制的快捷键,是因为在终端中,Ctrl+C的作用是“中断当前进程”,后面也用到了它中断当前进程的功能,我临时把快捷键改了回来。


开始搭建

从买VPS到搭站成功一共16小时,不清楚是不是Pullopen站的教程过期,总之二八法则诚不欺我,差不多13小时都在踩坑,很多坑最后我也没弄明白怎么回事,非常稀里糊涂,能跑起来真是谢天谢地谢Roelxy耳提面命一步一步教命令和确认结果,谢纯之教会我遇事不决重装VPS,谢我自己周天早上一拍脑门换参考教程。

这里只记一下大概的步骤流程,本来打算把所有命令的反馈和检查也记一下的,但我不小心把终端整个儿关了查不到历史记录,非常遗憾。

域名我之前就有,更换名称服务器为Cloudfare的名称服务器,在Cloudfare激活站点,之后新添子域名,A记录指向VPS IP,将代理状态改为仅限DNS。

邮件用了Zoho的邮箱服务,但没有配置好,暂时先搁置了。


首先在Contabo控制面板重装VPS(之前没搞定,有残留且删不掉的数据库,干脆重装),重装时系统换成Debian10(之前用Ubuntu20.04也总报错,不确定是不是Ubuntu的问题,但据纯之说他用Debian10没问题,玄学一下)

之后按Docker快速部署Mastodon的教程来,补充了一些操作时看的内容,仅供参考:

安装需要用到的软件包:Curl 的用法指南

apt -y update
apt -y install curl git nginx python-certbot-nginx

安装Docker:Systemd 入门教程:命令篇

curl -sSL https://get.docker.com/ | sh
systemctl enable --now nginx docker

安装Docker-compose:Linux chmod命令

curl -L https://github.com/docker/compose/releases/download/1.27.4/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

之后检查一下是不是装好了:

docker -v //检查Docker版本
Docker version 20.10.11, build dea9396 //返回内容
docker-compose --version //检查Docker-compose
docker-compose version 1.27.4, build 40524192 //返回内容

按Lalaim的教程,长毛象配置文件夹(也就是yml所在的文件夹)是/opt/mastodon,所以之后拉取文件在opt目录下进行,拉取后定位到/opt/mastodon再操作其他的。

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

复制配置文件,再重命名原来自带的配置文件:Linux cp 命令Linux mv 命令

cp .env.production.sample .env.production
mv docker-compose.yml docker-compose.yml.bak

编辑docker-compose.yml

nano docker-compose.yml

之后开始修改配置,这里要参考Pullopen的教程,把数据库版本之类的改一改:

version: '3.5'

services:
  mastodon-db:
    image: postgres:9.6-alpine //这里把9.6换成12.5
    shm_size: 256mb
    environment:
      POSTGRES_DB: mastodon //注意名称为mastodon
      POSTGRES_USER: 设置为你想要的数据库用户名
      POSTGRES_PASSWORD: password //数据库密码
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "postgres"]
    volumes:
      - ./postgres:/var/lib/postgresql/data
    restart: unless-stopped

  mastodon-redis:
    image: redis:6.0-alpine
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
    volumes:
      - ./redis:/data
    restart: unless-stopped

  mastodon-web:
    image: tootsuite/mastodon //改为image: tootsuite/mastodon:latest
    env_file: .env.production
    command: bash -c "rm -f /mastodon/tmp/pids/server.pid; bundle exec rails s -p 3000"
    depends_on:
      - mastodon-db
      - mastodon-redis
    healthcheck:
      test: ["CMD-SHELL", "wget -q --spider --proxy=off localhost:3000/health || exit 1"]
    ports:
      - "127.0.0.1:3000:3000"
    volumes:
      - ./public/system:/mastodon/public/system
    restart: unless-stopped

  mastodon-streaming:
    image: tootsuite/mastodon //改为image: tootsuite/mastodon:latest
    env_file: .env.production
    command: node ./streaming
    depends_on:
      - mastodon-db
      - mastodon-redis
    healthcheck:
      test: ["CMD-SHELL", "wget -q --spider --proxy=off localhost:4000/api/v1/streaming/health || exit 1"]
    ports:
      - "127.0.0.1:4000:4000"
    restart: unless-stopped

  mastodon-sidekiq:
    image: tootsuite/mastodon //改为image: tootsuite/mastodon:latest
    env_file: .env.production
    command: bundle exec sidekiq
    depends_on:
      - mastodon-db
      - mastodon-redis
    volumes:
      - ./public/system:/mastodon/public/system
    restart: unless-stopped

然后开始配置Mastodon,运行:

docker-compose run --rm mastodon-web bundle exec rake mastodon:setup

出现Domain name时,依次输入以下配置

Domain name: # Mastodon域名
Do you want to enable single user mode? # Yes //这里也可以用no,单人模式下不开放注册页面,访问域名会直接跳转到你的Mastodon主页
Are you using Docker to run Mastodon? # Yes
PostgreSQL host: # mastodon-db //注意名称
PostgreSQL port: # 5432 //默认端口,直接回车就行
Name of PostgreSQL database: # mastodon //注意名称
Name of PostgreSQL user: 刚刚填的数据库用户名
Password of PostgreSQL user: # 刚刚写的数据库密码,填写时不显示填写内容,盲敲后回车就行,出错/成功时都有很明显的提示
Redis host: # mastodon-redis //注意名称
Redis port: # 6379 //默认端口,直接回车
Redis password: # 留空,直接回车
Do you want to store uploaded files on the cloud? # No //这里是问文件要不要上云存储,可以暂时先不上,之后再根据情况做修改
Do you want to send e-mails from localhost? # Yes //是不是从主机发邮件?
Send a test e-mail with this configuration right now? # No //问是不是要发测试邮件,No掉它
Save configuration? Yes //是否保存

Yes后会立刻返回一大段内容,格式和上面这段代码块差不多,立刻保存下来,之后要用。

看到这段提示后退出来,教程说Ctrl+C退出,但之前我把Ctrl+C改成了复制键,这里改回来也很简单,Termius有不同的快捷键文件,暂时改回原来的文件就好。

Prepare the database now? (Y/n)

之后清空默认配置,并编辑配置文件,把刚刚保存的配置内容复制进去:如何使用echo指令向文件写入内容

echo > .env.production
nano .env.production

再重新运行一次配置向导,确保配置和上面保持一致

docker-compose run --rm mastodon-web bundle exec rake mastodon:setup
Prepare the database now? (Y/n) # Yes
Compile the assets now? (Y/n) # Yes
Do you want to create an admin user straight away? Yes //创建管理员账号,这一步会为你创建一个Mastodon账号
Username:Mastodon账号名
E-mail: 填个常用邮箱吧
You can login with the password:这部分是Mastodon密码,记得保存
You can change your password once you login.

开启容器内服务,把public的目录所有者改为容器内的

docker-compose up -d
chown -R 991:991 public

复制nginx的站点配置文件并编辑

cp /opt/mastodon/dist/nginx.conf /etc/nginx/conf.d/mastodon.conf
nano /etc/nginx/conf.d/mastodon.conf

改动配置文件内容如下:

……

server {
    if ($host = toot.mantyke.icu) {
        return 301 https://$host$request_uri;
    } # managed by Certbot


  listen 80;
  listen [::]:80;
  server_name Mastodon域名; 
  root /opt/mastodon/public; //改为public目录的绝对路径
  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 Mastodon域名;

  ……

  root /opt/mastodon/public; //改为public目录的绝对路径

  ……

最后签发SSL证书,有一些需要选择的部分看情况选就行了

certbot --nginx

稍等一会儿,刷新Mastodon域名,就看到站点上线了,Hello World!


遇到的坑

这里大概写一下遇到的坑……遇到挺多坑的,大部分也没搞清楚,总之于遇事不决上VPS控制面板重装机器,人是光脚不愁嘛。

一开始走到最后一步发现域名只能显示Nginx页面,可能是数据库出错。想把数据库删掉,但用了各种方法都还残留了一部分。只能重装机子后再搞,但证书又装不上,装上了又有个什么服务在不断重启启动失败,伴随着全过程的zoho邮箱配置失败,总之焦头烂额。

常用重启功能:

docker-compose down
docker-compose up -d

猜测Zoho配置失败是因为SMTP server用了欧洲版的地址(smtp.zoho.eu),改成国际版(smtp.zoho.com)可能就可以了,暂时不考虑开放注册,因此再说再说。

通过管理命令行也可以增加账号,不打算增加太多用户的话,好像也没必要一定配置邮件功能。

4.29日补充:数据库出错,不断重启,之后找到了一个解决办法(没有尝试过)可能有效:列出资料库容器并删除相关数据,命令如下:

docker volume ls -q 列出资料库容器
docker volume rm 容器名称 #删除数据

Zoho配置失败的猜想是正确的,是因为SMTP server需要配置为国际版的地址,附上我之后使用的配置做参考:

SMTP_SERVER=smtp.zoho.com
SMTP_PORT=587
[email protected](设定好的zoho发件邮箱)
SMTP_PASSWORD=密码
SMTP_AUTH_METHOD=plain
SMTP_OPENSSL_VERIFY_MODE=none
SMTP_FROM_ADDRESS=mastodon <[email protected]>


登录注册后才能评论。