请问这种要怎么处理，谢谢~~

本篇有标题党的嫌疑，下面的内容也缺乏原创性。

Pleroma主题设计教程详见官方文档：https://docs-develop.pleroma.social/backend/configuration/howto_theming_your_instance/

本篇只是做了一点点翻译。希望通过这篇文章，介绍一些已有的漂亮pleroma主题，让各位有兴趣的朋友来欣赏Pleroma的美丽^_^

快速便捷地设计您的Pleroma站点风格

• 您可以使用Pleroma FE创建自己的主题，方法是转到设置（右上角的齿轮）并选择主题选项卡。在这里，您可以选择创建个人主题。

• 可以根据图上的红框与箭头开始手动制作（瞎改）主题

• 
• 
• 
• 
• 
• 
• 
• 

经过上面的步骤，您已经获得了一个自己制作的pleroma主题文件。

当然，您也可以去访问别的pleroma站点，在齿轮设置里面保存并下载该站的主题；
或者访问一些提供pleroma主题的网址：
https://mindpalace.michaelis.website/tech/pleroma-theme.html
https://plthemes.vulpes.one/

将漂亮主题上传到您自己的vps

下面的操作以Bitvise SSH Client为例

• 重命名刚刚下载的那个json文件，例如命名为XXX.json
• 打开该文件，添加下列代码（注意括号），并且保存

{
"_pleroma_theme_version": 2,
"name": "XXX",
"theme": {}
}

• 访问VPS中存放Pleroma主题文件的地址

/var/lib/pleroma/static/frontends/pleroma-fe/develop/static/themes
（可能与您的安装路径有些许出入）

• 将修改好的XXX.json上传到这里

• 修改/var/lib/pleroma/static/frontends/pleroma-fe/develop/static 中的styles.json文件代码

{
"pleroma-dark": [ "Pleroma Dark", "#121a24", "#182230", "#b9b9ba", "#d8a070", "#d31014", "#0fa00f", "#0095ff", "#ffa500" ],
"pleroma-light": [ "Pleroma Light", "#f2f4f6", "#dbe0e8", "#304055", "#f86f0f", "#d31014", "#0fa00f", "#0095ff", "#ffa500" ],
"classic-dark": [ "Classic Dark", "#161c20", "#282e32", "#b9b9b9", "#baaa9c", "#d31014", "#0fa00f", "#0095ff", "#ffa500" ],
"bird": [ "Bird", "#f8fafd", "#e6ecf0", "#14171a", "#0084b8", "#e0245e", "#17bf63", "#1b95e0", "#fab81e"],
"ir-black": [ "Ir Black", "#000000", "#242422", "#b5b3aa", "#ff6c60", "#FF6C60", "#A8FF60", "#96CBFE", "#FFFFB6" ],
"monokai": [ "Monokai", "#272822", "#383830", "#f8f8f2", "#f92672", "#F92672", "#a6e22e", "#66d9ef", "#f4bf75" ],
"redmond-xx": "/static/themes/redmond-xx.json",
"redmond-xx-se": "/static/themes/redmond-xx-se.json",
"redmond-xxi": "/static/themes/redmond-xxi.json",
"breezy-dark": "/static/themes/breezy-dark.json",
"breezy-light": "/static/themes/breezy-light.json",
"mammal": "/static/themes/mammal.json",
"XXX": "/static/themes/XXX.json"
}

• 此刻，您可以来到Pleroma站点，点击齿轮设置，在网站预置主题中，您会发现列表里面多出了一个XXX的选项，恭喜，您的漂亮主题上传成功了

• 然后，您可以登陆Pleroma Fe-Settings-Frontend-Theme,输入XXX，将其设置为默认配置主题

我很欣赏的某些Pleroma站点的漂亮主题展示

希望您也喜欢！

The Pleroma Themes (michaelis.website)
Themes Gallery (cobaltkiss.blue)

Pleroma 官方 OTP 方式安装教程： https://docs-develop.pleroma.social/backend/installation/otp_en/

（因话题字数受限删除了「正式安装」前的内容，完整文章请点击上方博文链接查看）

推荐配置

尽管 Pleroma 内存需求远低于 Mastodon 和 Misskey，但购入 VPS 请最低保证 1 GB 的内存。这个配置对于用户较少的小型实例是足够的，再小实例就容易变得不稳定。如果预计会在未来接纳更多用户，请根据您需要购买更合适的套餐。

正式安装

一、前置安装

1、安装依赖

apt install curl unzip libncurses5 postgresql postgresql-contrib nginx certbot libmagic-dev

如果安装途中出现错误，则执行以下命令后再次尝试安装：

apt-get update

2、安装可选安装包（建议全部安装）

apt install imagemagick ffmpeg libimage-exiftool-perl

3、Postgresql 性能调优（可选）
为了优化性能，您可以使用 pgTune 生成一个合适的配置文件。编辑 /etc/postgresql/11.9/main/postgresql.conf 中的相应数值并使用以下命令重启 PostgreSQL 。

systemctl restart postgresql

（11.9 为我系统 Postgresql 的版本，您的版本不同的话会显示为其他序号）

二、安装 Pleroma

1、创建一个 Pleroma 用户

adduser --system --shell /bin/false --home /opt/pleroma pleroma

2、检测并设置环境变量 FLAVOUR

arch="$(uname -m)";if [ "$arch" = "x86_64" ];then arch="amd64";elif [ "$arch" = "armv7l" ];then arch="arm";elif [ "$arch" = "aarch64" ];then arch="arm64";else echo "Unsupported arch: $arch">&2;fi;if getconf GNU_LIBC_VERSION>/dev/null;then libc_postfix="";elif [ "$(ldd 2>&1|head -c 9)" = "musl libc" ];then libc_postfix="-musl";elif [ "$(find /lib/libc.musl*|wc -l)" ];then libc_postfix="-musl";else echo "Unsupported libc">&2;fi;echo "$arch$libc_postfix"

假设输出结果是 "amd64"（请替换为您自己的输出结果），输入 ：

export FLAVOUR="amd64"

3、下载安装 Pleroma 所需的文件到 /tmp 文件夹并解压

su pleroma -s $SHELL -lc "
curl 'https://git.pleroma.social/api/v4/projects/2/jobs/artifacts/stable/download?job=$FLAVOUR' -o /tmp/pleroma.zip
unzip /tmp/pleroma.zip -d /tmp/
"

4、移动文件到 /opt/pleroma 并删除临时文件夹

su pleroma -s $SHELL -lc "
mv /tmp/release/* /opt/pleroma
rmdir /tmp/release
rm /tmp/pleroma.zip
"

5、创建 /uploads 文件夹并设置适当的权限

mkdir -p /var/lib/pleroma/uploads
chown -R pleroma /var/lib/pleroma

6、创建 static 文件（用于存放表情等文件）并设置其所有者为用户 pleroma

mkdir -p /var/lib/pleroma/static
chown -R pleroma /var/lib/pleroma

7、创建存放配置文件的文件夹并设置其所有者为用户 pleorma

mkdir -p /etc/pleroma
chown -R pleroma /etc/pleroma

8、生成 config 配置文件

su pleroma -s $SHELL -lc "./bin/pleroma_ctl instance gen --output /etc/pleroma/config.exs --output-psql /tmp/setup_db.psql"

9、若 config 文件生成成功，则出现若干问题需要回答：

What domain will your instance use? (e.g pleroma.soykaf.com) []
您的网站将使用什么网址？

What is the name of your instance? (e.g. Pleroma/Soykaf) []
您的网站叫什么名字？

What is your admin email address? []
网站管理员的邮箱地址是什么？

What email address do you want to use for sending email notifications?
[]
您想要用什么邮件地址来发送邮件通知？（这里先输入邮箱，之后若要向用户发送邮件需要额外配置）

Do you want search engines to index your site? (y/n) [n]
您希望搜索引擎收录您的网站吗？（建议不收录）

Do you want to store the configuration in the database (allows controlling it from admin-fe)? (y/n) [n] y
您希望将配置信息存入数据库吗（允许从管理后台进行控制）？（建议存入，否则 admin-fe 将无法使用）

Do you want to strip location (GPS) data from uploaded images? (y/n) [y] n
您希望从上传的图片中消除 GPS 信息吗？（建议消除）

Do you want to anonymize the filenames of uploads? (y/n) [n] y
您希望将上传文件的文件名匿名化吗？（建议匿名化）

Do you want to deduplicate uploaded files? (y/n) [n] y
您希望去除重复的已上传文件吗？（建议去除）

除以上问题外，其余选项均按 enter 选择默认配置即可

如果成功则有如下显示：

All files successfully written! Refer to the installation instructions for your platform for next steps. Please transfer your config to the database after running database migrations. Refer to "Transfering the config to/from the database" section of the docs for more information.

10、创建 postgres 数据库

su postgres -s $SHELL -lc "psql -f /tmp/setup_db.psql"

11、更新数据库 schema

su pleroma -s $SHELL -lc "./bin/pleroma_ctl migrate"

12、启动实例以验证一切都按预期工作

su pleroma -s $SHELL -lc "./bin/pleroma daemon"

13、等待大约 60 秒并检测实例运行状况，如果它正确地显示了您的网址、网站名称和电子邮件地址，则说明实例已经安装成功（update: 经建议，由 20 秒延长为 60 秒）

sleep 60 && curl http://localhost:4000/api/v1/instance

注：如果出现错误 "curl: (7) Failed to connect to localhost port 4000: Connection refused" ，请等待一会儿再此尝试，错误可能是 Pleroma 初次加载时间较慢导致的。

14、最后，暂时先暂停实例的运行

su pleroma -s $SHELL -lc "./bin/pleroma stop"

三、设置 nginx 并获取 Let’s Encrypt SSL 证书

1、获取一个 Let’s Encrypt 证书（注意修改域名）

certbot certonly --standalone --preferred-challenges http -d <yourinstance.tld>

2、输入您的邮箱地址（用于紧急重建和安全通知）并按照指示选择 A（agree）和 Y(yes)

*之前 Let’s Encrypt 曾撤销了一批有问题的证书，撤销前曾通过邮件进行通知，请务必留下一个有效的联系邮件。**

3、显示以下结果证明证书获取成功（否则尝试再次执行第一个指令）：

Congratulations! Your certificate and chain have been saved at: /etc/letsencrypt/live/<实例域名>/fullchain.pem Your key file has been saved at: /etc/letsencrypt/live/<实例域名>/privkey.pem Your cert will expire on <到期日期>. To obtain a new or tweaked version of this certificate in the future, simply run certbot again. To non-interactively renew all of your certificates, run "certbot renew"……（省略）

注：如果提示与我上面写的不同，请仔细检查证书有没有成功申请并存放到"/etc/letsencrypt/live/实例域名/"，若没有申请成功，后面依旧会卡住。

一般这一步出错有两种可能，第一，您没有添加 A 记录，请到域名注册网站添加或修改 A 记录；二，80 和 443 端口未开放，如果这里出现错误"Problem binding to port 80: Could not bind to IPv4 or IPv6."，请检查防火墙端口开放情况（Debian 需要额外安装 ufw）：sudo ufw status verbose，如果只有 22 端口开放，请通过 sudo ufw allow 80/tcp、sudo ufw allow 443/tcp 将 80 和 443 端口开放。(*备注)

操作完成后，再次输入指令，直到看到正确的成功提示。

4、复制 Pleroma nginx 配置到 nginx 文件夹

cp /opt/pleroma/installation/pleroma.nginx /etc/nginx/sites-available/pleroma.conf
ln -s /etc/nginx/sites-available/pleroma.conf /etc/nginx/sites-enabled/pleroma.conf

5、使用 nano 编辑器打开 Nginx 配置文件

nano /etc/nginx/sites-available/pleroma.conf

6、将文件中所有 example.tld 更改为您的实例的对应名称（操控方向键滑动页面，用 backspace 删除默认名称，并输入新的地址即可）

注（未经验证）：location 处只保留后面的$符号，删除前面的$符号）：

location / {
  return         301 https://<您的实例名>$request_uri;
}

7、修改完毕后按 ctrl X，选择 Y（yes）保存，然后按 enter 退出

8、确认 nginx 是否配置正确

nginx -t

出现以下内容则配置成功：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

9、启动 nginx（若先前 nginx 已在运行则 reload nginx -s reload）

systemctl start nginx

四、设置系统服务

1、将 pleroma.service 复制到适当的文件夹中

cp /opt/pleroma/installation/pleroma.service /etc/systemd/system/pleroma.service

2、启动 pleroma 并设置开机自启动

systemctl start pleroma
systemctl enable pleroma

在地址栏输入您的实例域名，若 pleroma 服务启动成功，则应显示 pleroma 页面；若显示 502 bad gateway，再次执行 systemctl start pleroma ，之后刷新页面

五、设置 Let’s Encrypt 证书的自动更新

这部分内容可以参考 → 通配符域名证书申请与自动更新

1、创建路径

mkdir -p /var/lib/letsencrypt

2、使用 nano 编辑器打开 Nginx 配置文件

nano /etc/nginx/sites-available/pleroma.conf

3、去除
location ~ /.well-known/acme-challenge { root /var/lib/letsencrypt/; }
前的 # 注释符号

内容全部显示为白色后按 ctrl X，选择 Y（yes）保存，然后按 enter 退出

4、确认配置是否正确

nginx -t

5、重启 nginx

systemctl restart nginx

6、确认自动更新任务设置成功（注意修改域名）

certbot renew --cert-name <yourinstance.tld> --webroot -w /var/lib/letsencrypt/ --dry-run --post-hook 'systemctl reload nginx'

显示以下内容则设置成功：
Congratulations, all renewals succeeded. The following certs have been renewed: /etc/letsencrypt/live/yourinstance.tld/fullchain.pem (success)
** DRY RUN: simulating 'certbot renew' close to cert expiry
** (The test certificates above have not been saved.)

7、添加自动任务（注意修改域名）

echo '#!/bin/sh
certbot renew --cert-name <yourinstance.tld> --webroot -w /var/lib/letsencrypt/ --post-hook "systemctl reload nginx"
' > /etc/cron.daily/renew-pleroma-cert
chmod +x /etc/cron.daily/renew-pleroma-cert

8、确认任务添加成功

run-parts --test /etc/cron.daily

若显示内容中包含 /etc/cron.daily/renew-pleroma-cert 则添加成功

六、创建第一个用户并设置为管理员

<joeuser> 处为管理员 ID，后面为管理员邮箱地址，根据自己情况设置

cd /opt/pleroma/bin
su pleroma -s $SHELL -lc "./bin/pleroma_ctl user new <joeuser> <joeuser@sld.tld> --admin"

选择 [y] 后终端会出现一个链接，复制链接并粘贴到浏览器打开，为管理员账号设置密码，设置完毕即可进入实例页面。

一些可能对您有帮助的文章:

• 形形色色 - 各种的建站教程以及一些建站所需要的基本知识
• 尽量细致的Pleroma搭建教程（仮）
• 一份友好的联邦宇宙介绍
• 我的pleroma搭建笔记

pleroma systemd service 在arch上跑不起来

如果在config中设置了Exiftool的话

config :pleroma, Pleroma.Upload, filters: [Pleroma.Upload.Filter.Exiftool]

即使装了exiftool (extra/perl-image-exiftool)，启动pleroma服务时他也会报错说找不到exiftool (not in path)。这是因为 archlinux 会把perl包放在 /usr/bin/vendor_perl/ 下，并通过/etc/profile.d/perlbin.sh导入 PATH，而倒霉的systemd在加载服务的时候并不认这一套，所以会找不到exiftool的可执行文件而报错退出。

参考这个issue

一个简单而愚蠢的方法是把exiftool 软链接到一个systemd认识的PATH里去，e.g.

ln -s /usr/bin/core_perl/exiftool /usr/local/bin/exiftool

postgresql 更新

众所周知arch是滚动升级的，而postgresql大版本之间的数据文件是不通用的，搞不好哪天pacman -Syu 就把数据库给扬了, 所以建议让pacman 跳过对postgresql的更新

如果需要升级postgresql大版本，需要使用pg_upgrade工具迁移数据。如果你不幸忘记迁移数据就升级了postgresql，又把之前版本的postgres给删了，extra/postgresql-old-upgrade 贴心地提供了后悔药，它提供了上一个postgresql大版本的一些可执行文件。

总之，为了抢救数据库，需要做以下步骤：

# 暂停postgresql服务
sudo sytemd stop postgresql

# 备份数据
mv /var/lib/postgres/data /var/lib/postgres/olddata

# 创建临时工作目录
mkdir /var/lib/postgres/data /var/lib/postgres/tmp
chown postgres:postgres /var/lib/postgres/data /var/lib/postgres/tmp

# 切换到 postgres 用户: 
sudo -iu postgres
cd /var/lib/postgres/tmp

# 初始化新版本postgresql的数据文件
# 注意此命令的相关参数要和创建旧版本数据库时一致，如果数据库是按照pleroma默认安装教程创建的，可以使用如下的命令。
initdb -D /var/lib/postgres/data 

# 迁移数据
# 将<PG_VERSION>替换为上个版本号，例如从psql 13升级到14，这里就填13。
pg_upgrade -b /opt/pgsql-<PG_VERSION>/bin -B /usr/bin -d /var/lib/postgres/olddata

# 重启数据库
sudo systemd restart postgresql

注: 视情况可能需要对pleroma进行迁移 (mix ecto.migrate) 或者对数据库进行REINDEX

ref https://wiki.archlinux.org/title/PostgreSQL#pg_upgrade