如何在VPS上搭建派克斯(Pixelfed)？

步骤	操作说明	使用工具
1	准备VPS服务器	DigitalOcean/Hetzner
2	安装Docker和Docker Compose	Linux命令行
3	克隆Pixelfed仓库	git命令
4	构建Docker镜像	docker build命令
5	配置Traefik反向代理	Traefik配置文件

VPS搭建派克斯(Pixelfed)完整指南

派克斯(Pixelfed)是一个开源的图片社交平台，支持联邦网络(Fediverse)功能。本文将详细介绍如何在VPS上搭建Pixelfed平台。

准备工作

在开始搭建前，您需要准备以下内容：

• 一台运行Linux系统的VPS服务器(推荐DigitalOcean或Hetzner)
• 已注册并解析到VPS IP的域名
• 基本的Linux命令行操作知识
• Docker和Docker Compose已安装

详细搭建步骤

1. 设置VPS环境

首先通过SSH连接到您的VPS服务器，建议使用root用户登录。更新系统软件包：

sudo apt update && sudo apt upgrade -y

2. 安装必要工具

安装Docker和Docker Compose：

curl -fsSL https://get.docker.com | bash
sudo usermod -aG docker $USER
sudo systemctl enable --now docker
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

3. 获取Pixelfed代码

创建项目目录并克隆Pixelfed仓库：

sudo mkdir -p /opt/pixelfedsource
sudo chown $USER:$USER /opt/pixelfedsource
git clone git@github.com:pixelfed/pixelfed.git /opt/pixelfed
cd /opt/pixelfed

4. 构建Docker镜像

使用以下命令构建Docker镜像(请将v0.9.4替换为最新版本号)：

docker build -t pixelfed:v0.9.4 .

5. 配置Traefik反向代理

创建Traefik配置文件traefik.toml：

[entryPoints]
  [entryPoints.web]
  address = ":80"
  [entryPoints.websecure]
  address = ":443"
[api]
entryPoint = "web"
[providers]
  [providers.docker]
  exposedByDefault = false
[acme]
email = "your@email.com"
storage = "acme.json"
[acme.httpChallenge]
entryPoint = "web"

常见问题解决方案

问题	原因	解决方案
镜像构建失败	网络问题或依赖缺失	检查网络连接，重新运行构建命令
无法访问网站	Traefik配置错误	检查Traefik配置文件中的域名设置
数据库连接失败	数据库服务未启动	检查Docker容器状态，重启数据库服务
图片上传失败	存储权限不足	检查存储目录权限，确保Pixelfed有写入权限

相关资源

• Pixelfed官方文档
• Pixelfed移动应用
• Docker官方文档

通过以上步骤，您应该已经成功在VPS上搭建了Pixelfed平台。如有其他问题，可以参考Pixelfed官方社区或相关技术论坛寻求帮助。