開源微博軟體Pleroma 服務器的搭建詳細教程
您需要一台服務器或 VPS。幾乎所有操作系統都受支持,但對於本教程,我假設您使用的是基於 Debian 的操作系統。您還需要一個指向服務器 IP 地址的域名
折騰了幾天,發現安裝失敗最多的就是權限問題導致安裝失敗,建議使用root權限安裝,然後在設置相關權限
另外一定要賦予bin目錄下文件執行權限
安裝
設置和配置
首先,您需要確保您已經強化了 SSH,以便禁用密碼身份驗證,並且您還需要設置 Fail2Ban。
接下來我們將安裝所需的包:
1
apt install -y curl unzip libncurses5 postgresql postgresql-contrib nginx certbot libmagic-dev
您可以手動配置 postgreSQL 以更好地適應您的系統。在此處查看文檔,然後運行以下命令:
1
systemctl restart postgresql
安裝 Pleroma 應用程序
首先作為root用戶
Pleroma 不在 Debian 應用程序存儲庫中,因此我們將手動安裝它。首先通過運行以下命令創建 Pleroma 用戶:
1
useradd -m -s /bin/bash -d /opt/pleroma pleroma
然後,仍然以 root 身份,我們將創建所需的目錄並授予 Pleroma 用戶對它們的所有權。
1
2
3
4
5
6
mkdir -p /var/lib/pleroma/uploads
chown -R pleroma /var/lib/pleroma
mkdir -p /var/lib/pleroma/static
chown -R pleroma /var/lib/pleroma
mkdir -p /etc/pleroma
chown -R pleroma /etc/pleroma
現在,作為新的 Pleroma 用戶
現在運行su -l pleroma
以 Pleroma 用戶身份登錄。現在使用以下curl
命令下載 Pleroma 軟件並解壓縮。
1
2
curl 'https://git.pleroma.social/api/v4/projects/2/jobs/artifacts/stable/download?job=amd64' -o /tmp/pleroma.zip
unzip /tmp/pleroma.zip -d /tmp/
請注意,我們在此處下載amd64版本。如果您知道您有不同的 CPU 架構,請將其替換為您的架構。
1
2
3
4
mv /tmp/release/* /opt/pleroma
rmdir /tmp/release
rm /tmp/pleroma.zip
./bin/pleroma_ctl instance gen --output /etc/pleroma/config.exs --output-psql /tmp/setup_db.psql
我們需要簡單地返回到 root 用戶,以便我們可以運行以下命令(通過 postgres 用戶)來設置數據庫。輸入ctrl-d
或運行exit
返回root用戶,然後運行:
1
su postgres -s $SHELL -lc "psql -f /tmp/setup_db.psql"
然後返回給 pleroma 用戶,su -l pleroma
我們將測試 Pleroma 是否可以運行:
1
2
./bin/pleroma_ctl migrate
./bin/pleroma daemon
這將初始化 Pleroma。開始可能需要一分鐘,所以請稍等,然後運行以下命令:
1
curl http://localhost:4000/api/v1/instance
如果一切正常,這個命令會給你一長串凌亂的輸出。如果不是,您將收到一條連接錯誤消息。成功運行後,停止 Pleroma 守護程序,我們將 Pleroma 與 Web 服務器連接。
1
./bin/pleroma stop
設置和配置 Nginx
再次返回 root 用戶。讓我們從安裝中給出的模板中復制 Pleroma 的 Nginx 配置文件並啟用它:
1
2
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
編輯etc/nginx/sites-available/pleroma.conf
文件並將domain.com替換為您的域名。
我們現在必須獲得 SSL 證書才能啟用加密,因為我們的模型配置已經包含 SSL 信息,。完成證書設置後,使用以下命令複製 Nginx 配置:
一旦一切就緒,包括您的 Cerbot 證書,只需使用以下命令重新加載 Nginx:
1
systemctl reload nginx
設置服務
Pleroma 本身在 SystemD 服務上運行,類似於在您的服務器上運行的其他東西,如 Nginx。要啟動服務,請運行以下命令:
1
2
3
cp /opt/pleroma/installation/pleroma.service /etc/systemd/system/pleroma.service
systemctl start pleroma
systemctl enable pleroma
如果一切正常,那麼當您在 Web 瀏覽器中訪問您的域時,您應該會看到一個基本的 Pleroma 實例。
創建管理員用戶
您將能夠在網站的登錄部分中的 Pleroma 實例上創建新帳戶,但設置管理員帳戶的最簡單方法是使用 CLI。只需運行以下替換為您的用戶名的命令:
1
2
su -l pleroma
./bin/pleroma_ctl user new username [email protected] --admin
如果您遇到任何問題,請隨時查看文檔。