Mastodon | 记录大型魔改过程

一直很想让长毛象支持 Markdown语法，但我本人却因为菜得看不懂真代码而多次碰壁。这次使用了小森林站长的docker镜像，主题和特色请看这里。

注：小森林站源代码按照AGPL3协议开源，所有资源都不依赖小森林站长的服务器资源。自行部署可参考本文实践，没有经过大型魔改的站点理论上讲都可以平滑迁移。

本文的劳动成果部分属于mashiro，本文仅作备忘使用，鞠躬。

备份配置文件#

1
cp docker-compose.yml docker-compose.save && vim docker-compose.save

原配置如下：

1
version: '3'
2
services:
3

4
  db:
5
    restart: always
6
    image: postgres:12.5-alpine
7
    shm_size: 256mb
8
    networks:
9
      - internal_network
10
    healthcheck:
11
      test: ["CMD", "pg_isready", "-U", "postgres"]
12
    volumes:
13
      - ./postgres:/var/lib/postgresql/data
14

15
  redis:
16
    restart: always
17
    image: redis:6.0-alpine
18
    networks:
19
      - internal_network
20
    healthcheck:
21
      test: ["CMD", "redis-cli", "ping"]
22
    volumes:
23
      - ./redis:/data
24

25
  es:
26
    restart: always
27
    image: docker.elastic.co/elasticsearch/elasticsearch-oss:7.10.2
28
    environment:
29
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
30
      - "cluster.name=es-mastodon"
31
      - "discovery.type=single-node"
32
      - "bootstrap.memory_lock=true"
33
    networks:
34
      - internal_network
35
    healthcheck:
36
      test: ["CMD-SHELL", "curl --silent --fail localhost:9200/_cluster/health || exit 1"]
37
    volumes:
38
      - ./elasticsearch:/usr/share/elasticsearch/data
39
    ulimits:
40
      memlock:
41
        soft: -1
42
        hard: -1
43

44

45
  web:
46
    build: .
47
    image: pullopen/mastodon:v3.4.4
48
    restart: always
49
    env_file: .env.production
50
    command: bash -c "rm -f /mastodon/tmp/pids/server.pid; bundle exec rails s -p 3000"
51
    networks:
52
      - external_network
53
      - internal_network
54
    healthcheck:
55
      test: ["CMD-SHELL", "wget -q --spider --proxy=off localhost:3000/health || exit 1"]
56
    ports:
57
      - "127.0.0.1:3000:3000"
58
    depends_on:
59
      - db
60
      - redis
61
      - es
62
    volumes:
63
      - ./public/system:/mastodon/public/system
64

65
  streaming:
66
    build: .
67
    image: pullopen/mastodon:v3.4.4
68
    restart: always
69
    env_file: .env.production
70
    command: node ./streaming
71
    networks:
72
      - external_network
73
      - internal_network
74
    healthcheck:
75
      test: ["CMD-SHELL", "wget -q --spider --proxy=off localhost:4000/api/v1/streaming/health || exit 1"]
76
    ports:
77
      - "127.0.0.1:4000:4000"
78
    depends_on:
79
      - db
80
      - redis
81

82
  sidekiq:
83
    build: .
84
    image: pullopen/mastodon:v3.4.4
85
    restart: always
86
    env_file: .env.production
87
    command: bundle exec sidekiq
88
    depends_on:
89
      - db
90
      - redis
91
    networks:
92
      - external_network
93
      - internal_network
94
    volumes:
95
      - ./public/system:/mastodon/public/system
96
## Uncomment to enable federation with tor instances along with adding the following ENV variables
97
## http_proxy=http://privoxy:8118
98
## ALLOW_ACCESS_TO_HIDDEN_SERVICE=true
99
#  tor:
100
#    image: sirboops/tor
101
#    networks:
102
#      - external_network
103
#      - internal_network
104
#
105
#  privoxy:
106
#    image: sirboops/privoxy
107
#    volumes:
108
#      - ./priv-config:/opt/config
109
#    networks:
110
#      - external_network
111
#      - internal_network
112

113
networks:
114
  external_network:
115
  internal_network:
116
    internal: true

由于偷懒没有自行制作镜像，这里我用了pullopen站长的镜像pullopen/mastodon:v3.4.4，感谢她。

1
cp .env.production .env.production.save && vim .env.production.save

原配置如下：

1
# Generated with mastodon:setup on 2021-06-12 10:34:39 UTC
2

3
LOCAL_DOMAIN=toot.tantalum.life
4
SECRET_KEY_BASE=
5
OTP_SECRET=
6
VAPID_PRIVATE_KEY=
7
VAPID_PUBLIC_KEY=
8
DB_HOST=db
9
DB_PORT=5432
10
DB_NAME=mastodon_production
11
DB_USER=mastodon
12
DB_PASS=
13
REDIS_HOST=redis
14
REDIS_PORT=6379
15
SMTP_SERVER=smtp.zoho.com
16
SMTP_PORT=587
17
[email protected]
18
SMTP_PASSWORD=
19
SMTP_AUTH_METHOD=plain
20
SMTP_OPENSSL_VERIFY_MODE=none
21
SMTP_FROM_ADDRESS=Mastodon <[email protected]>
22
S3_ENABLED=true
23
S3_BUCKET=
24
AWS_ACCESS_KEY_ID=
25
AWS_SECRET_ACCESS_KEY=
26
S3_REGION=nl-ams
27
S3_PROTOCOL=https
28
S3_HOSTNAME=s3.nl-ams.scw.cloud
29
S3_ENDPOINT=https://s3.nl-ams.scw.cloud/
30
S3_ALIAS_HOST=
31
GITHUB_REPOSITORY=pullopen/mastodon
32
AUTHORIZED_FETCH=true   #安全模式开启
33
ES_ENABLED=true
34
ES_HOST=es
35
ES_PORT=9200

备份数据库防止意外。

加入魔改配置#

经小森林站长提醒，如果默认用的是自定义主题，迁移前先把站点主题换成mastodon默认的深色主题。

运行docker-compose down使站点下线，开始我们的魔改工作。

打开docker-compose.yml示例代码，复制末尾的translate块部分。回到服务器运行nano docker-compose.yml，将刚刚复制的内容粘贴到服务器的docker-compose.yml文件的对应位置。

将web，streaming和sidekiq三项的image改为mashirozx/mastodon:latest，同时也将三个build字段注释掉。
将es项的image改为mashirozx/elasticsearch-cnplugin:7.16.1，保存。

如果你没有开启全文搜索，请参考这个教程开启全文搜索，直接把image改为mashirozx/elasticsearch-cnplugin:7.16.1即可。在本文结束后再运行docker-compose run --rm web bin/tootctl search deploy建立嘟文的搜索索引。

打开.env.production示例代码，第77行至末尾部分是小森林站长的改动。复制这部分内容，回到服务器运行nano .env.production，直接在后面粘贴就可。其中需要改动的的几个地方：

MAX_TOOT_CHARS=500是嘟文字数最大值，改为你喜欢的数字。
PLAUSIBLE_ANALYTICS_SITE_DOMAIN=hello.2heng.xin去掉注释并改为你的域名。
最末尾的GITHUB_OAUTH2和GITLAB_OAUTH2配置是Github和Gitlab登录方式，可以大胆注释掉。

现在可以使站点重新上线了：

1
docker-compose up -d

后续工作#

我之前的文章里提到，站点升级后可能会遇到刷嘟时提示网络错误500的报错。

此时需要进行数据库迁移：

1
docker-compose run --rm web rails db:migrate

另外，在两次升级时跨版本号太多，或是经过大型魔改后还需要运行tootctl cache clear命令，否则可能会出现与外站通信延迟高的问题：

1
docker-compose run --rm web bin/tootctl cache clear

重启长毛象载入改动，否则数据库迁移命令不会生效：

1
docker-compose down
2
docker-compose up -d

自定义CSS样式#

自定义CSS：

1
/*鼠标选中底色*/
2
*::selection {
3
    color: #fff;
4
    background-color: #b85798;
5
}
6

7
/*mastodon长图补丁 v2.1 by Shioko*/
8
.image-loader {
9
    align-items: center;
10
}
11
.zoomable-image {
12
    display: flex;
13
    max-height: 100%;
14
    max-width: 98%;
15
    overflow: auto !important;
16
}
17

18
.zoomable-image img {
19
  max-height: 100%;
20
    max-width:100%;
21
}
22

23
/*variable width*/
24
div.column {
25
 -webkit-box-flex:1;
26
 -ms-flex-positive:1;
27
 flex-grow:1
28
}
29

30
/*hashtag style blue by slashine 071320*/
31
.mention.hashtag{
32
background-color: #93AEFD36;
33
padding: 0px 4px;
34
text-align: center;
35
text-decoration: none;
36
display: inline-block;
37
border-style: dashed;
38
border-color: #93AEFD;
39
border-width: 0.5px;
40
border-radius: 2px;
41
margin-top: 2px;
42
margin-bottom: 2px;
43
}
44

45
/*emoji enlarge written by bgme*/
46
.reply-indicator__content .emojione,
47
.status__content .emojione {
48
    width: 30px !important;
49
    height: 30px !important;
50
}
51

52
.emoji-mart-category .emoji-mart-emoji:hover span {
53
    width: 45px !important;
54
    height: 45px !important;
55
}
56

57
.emoji-mart-category .emoji-mart-emoji:hover {
58
    margin: 0 -12px;
59
}
60

61
/* START mastodon emoji scaling by @[email protected] */
62
.account__header__content,
63
.reply-indicator__content,
64
.status__content:not(.status__content--collapsed) {
65
overflow: unset;
66
}
67
.account__header__content .emojione,
68
.reply-indicator__content .emojione,
69
.status__content:not(.status__content--collapsed) .emojione {
70
position: relative;
71
z-index: 10;
72
transform-origin: center;
73
/* Animation duration */
74
transition: 200ms ease-in-out;
75
}
76
.account__header__content .emojione:hover,
77
.reply-indicator__content .emojione:hover,
78
.status__content:not(.status__content--collapsed) .emojione:hover {
79
z-index: 11;
80
/* Scale up 2.3 times */
81
transform: scale(2.3);
82
/* shadows around image edges */
83
filter: drop-shadow(0 0 1px #282c37);
84
}
85
.directory__card .account__header__content .emojione:hover {
86
transform: unset;
87
}
88
/* END mastodon emoji scaling by @[email protected] */
89

90
/*cat ears written by dmonad & neb*/
91
.notification .status__avatar::before,
92
.notification .status__avatar::after {
93
  display: none !important;
94
}
95

96
.status__wrapper .status:first-child .status__avatar::before,
97
.status__wrapper .status:first-child .status__avatar::after,
98
.entry.h-entry .status__avatar div::before,
99
.entry.h-entry .status__avatar div::after,
100
.entry.entry-reblog .status__avatar div::before,
101
.entry.entry-reblog .status__avatar div::after {
102
  content: "";
103
  display: inline-block;
104
  border: 4px solid;
105
  box-sizing: border-box;
106
  width: 50%;
107
  height: 50%;
108
  background-color: inherit;
109
  border-color: inherit;
110
  position: absolute;
111
  z-index: 0;
112
}
113

114
.status__avatar::before,
115
.entry.h-entry .status__avatar div::before,
116
.entry.entry-reblog .status__avatar div::before {
117
  border-radius: 75% 0 75% 75%;
118
  transform: rotate(-37.6deg) skew(-30deg);
119
  right: 0;
120
}
121

122
.status__avatar::after,
123
.entry.h-entry .status__avatar div::after,
124
.entry.entry-reblog .status__avatar div::after {
125
  border-radius: 0 75% 75%;
126
  transform: rotate(37.6deg) skew(30deg);
127
  top: 0;
128
  left: 0;
129
}
130

131
.detailed-status__display-name {
132
  overflow: visible !important;
133
}
134

135
.detailed-status__display-avatar {
136
  position: relative;
137
}
138

139
.detailed-status__display-avatar::before,
140
.detailed-status__display-avatar::after {
141
  content: "";
142
  display: inline-block;
143
  border: 4px solid;
144
  box-sizing: border-box;
145
  width: 24px;
146
  height: 24px;
147
  background-color: inherit;
148
  border-color: inherit;
149
  position: absolute;
150
  z-index: 0;
151
}
152

153
.detailed-status__display-avatar::before {
154
  border-radius: 75% 0 75% 75%;
155
  transform: rotate(-37.6deg) skew(-30deg);
156
  right: 0px;
157
}
158

159
.detailed-status__display-avatar::after {
160
  border-radius: 0 75% 75%;
161
  transform: rotate(37.6deg) skew(30deg);
162
  top: 0;
163
}
164

165
.account__avatar {
166
  border-radius: 100%;
167
  z-index: 1;
168
}
169

170
.status__avatar:hover::before,
171
.detailed-status__display-avatar:hover::before,
172
.entry.h-entry .status__avatar div:hover::before,
173
.entry.entry-reblog .status__avatar div:hover::before {
174
  animation: earwiggleright 1s infinite;
175
}
176

177
.status__avatar:hover::after,
178
.detailed-status__display-avatar:hover::after,
179
.entry.h-entry .status__avatar div:hover::after,
180
.entry.entry-reblog .status__avatar div:hover::after {
181
  animation: earwiggleleft 1s infinite;
182
}
183

184
@keyframes earwiggleleft {
185
  from { transform: rotate(37.6deg) skew(30deg); }
186
  25% { transform: rotate(10deg) skew(30deg); }
187
  50% { transform: rotate(20deg) skew(30deg); }
188
  75% { transform: rotate(0deg) skew(30deg); }
189
  to { transform: rotate(37.6deg) skew(30deg); }
190
}
191

192
@keyframes earwiggleright {
193
  from { transform: rotate(-37.6deg) skew(-30deg); }
194
  30% { transform: rotate(-10deg) skew(-30deg); }
195
  55% { transform: rotate(-20deg) skew(-30deg); }
196
  75% { transform: rotate(-0deg) skew(-30deg); }
197
  to { transform: rotate(-37.6deg) skew(-30deg); }
198
}

SSL证书续签#

参考：How to install Mastodon Social Network with Docker on Ubuntu 18.04 LTS

Let’s Encrypt 证书的有效期为90天。之后需要再次更新。可以创建一个cron作业来自动为您完成。

创建一个cron作业：

1
nano /etc/cron.daily/letsencrypt-renew

将以下内容复制并粘贴到文件中。

1
#!/usr/bin/env bash
2
certbot renew
3
systemctl reload nginx

使脚本可执行并重新启动cron守护程序，以便脚本每天运行：

1
chmod +x /etc/cron.daily/letsencrypt-renew
2
systemctl restart cron

从他站爬取自定义表情包#

2022/04/22更新
爬取自定义表情包

一般情况下，作为站长当发现其他站点有好看的表情包想拥有的时候，最简单粗暴的方式是去网页端的管理后台将他站表情包复制到自家站点的数据库中。但是这样需要一个一个勾选表情包并复制，非常低效，只适用于一次性复制少量表情包。那么如何一次性将他站的一整个表情分类（甚至全部分类）全都偷过来呢？

偷表情神器应运而生啦！下面介绍emojidownloader的使用方法。此工具由兔酱编写，感谢ta！

以2022年3月更新的emojidownloader v0.1.0版本为例：

打开项目最新版本的Releases页面，找到emoji_downloader_linux_x86_64，右击复制其网址。

回到服务器进入/opt/mastodon目录，运行：

1
wget 你复制的网址
2
chmod +x ./emoji_downloader_linux_x86_64
3
./emoji_downloader_linux_x86_64

就可以开始偷表情了！

选择从url下载mastodon emoji，输入想要爬取表情包的站点域名。

1
是否使用代理？(y/N)  #直接回车
2
是否设置Mastodon Cookie？(y/N)  #直接回车

当出现以下错误时，说明站点开启了authorized_fetch（安全模式），需要拥有对方站帐号才能继续爬取表情。如果顺利解析到表情分类，可以直接将本文划到最末尾。

1
2022-04-22 02:01:06.105254 prompt.go:84 <plParseJson> |MAN| [INFO] 解析中......
2
2022-04-22 02:01:06.557876 prompt.go:87 <plParseJson> |MAN| [ERROR] 解析失败！请检查 http code not correct! got 401,resp text is {"error":"This method requires an authenticated user"}
3
出现错误，按任意键结束

如果你拥有对方站的帐号，请在浏览器中登录。随后打开浏览器的网页开发者工具（以Firefox为例：右上角Burger Menus -> 更多工具 -> 网页开发者工具）

刷新页面，找到最后一个GET方法的条目，点开就可以在右侧看到cookie了：

将得到的cookie复制下来备用。回到服务器重新运行偷表情神器：

1
./emoji_downloader_linux_x86_64

来到是否设置Mastodon Cookie？(y/N)这一步，这次我们选择y，然后输入刚刚得到的cookie的值（_mastodon_session开头），稍等一下就可以成功解析出表情包了。根据脚本提示选择表情包分类，随后：

1
是否开启白名单emoji名称？(y/N)
2
是否替换emoji名称？(y/N)
3
请输入保存文件夹(默认：./myEmojis)：
4
是否忽略下载中的单个emoji下载错误？(Y/n)
5
是否打包为压缩文件？(Y/n)
6
是否在打包为压缩文件后删除原始的下载文件(Y/n)
7
并发下载量(默认：16)：
8
是否显示下载日志？(Y/n)

以上全部一路回车。脚本运行的最后会有导入表情包的提示：

1
非docker：
2
RAILS_ENV=production bin/tootctl emoji import --category=自定义表情分类名 表情tar.gz文件地址
3

4
docker：
5
docker cp ./表情地址 web服务docker名:/tmp/表情名.tar.gz
6
docker-compose exec web bin/tootctl emoji import --category=自定义表情分类名 /tmp/表情名.tar.gz

表情包的默认下载地址是./myEmojis，web服务docker名可以运行docker ps查看，一般是mastodon-web-1，表情分类命名随意设置。

最后一步的过程比较慢，需要把表情包写入数据库中。成功之后就可以使用新鲜出炉的表情包啦~