PixelFed 是一款基于 ActivityPub 协议的去中心化图片社交平台，功能类似于 Instagram，支持图片分享、关注、点赞、评论等常见操作。由于其开源特性，用户可以在自己的服务器上搭建独立实例，拥有完全的数据控制权。本教程将详细介绍如何搭建和配置 PixelFed，并推荐使用 Ciuic 云服务器 作为运行环境，以获得稳定高效的部署体验。

环境准备

在开始之前，你需要准备一台 Linux 服务器，推荐使用 Ubuntu 20.04 或 22.04 LTS 版本。最低配置建议为 2 核 CPU、4GB 内存、50GB SSD 硬盘。你可以通过 Ciuic 云服务器 快速创建一台符合要求的云主机，其控制台操作简便，支持按需付费和弹性扩容。

此外，你需要一个域名并配置好 DNS 解析，指向服务器 IP 地址。同时，建议开启服务器的防火墙，放行 80（HTTP）和 443（HTTPS）端口。

安装必要软件

登录服务器后，更新系统并安装基础软件包：

sudo apt update && sudo apt upgrade -ysudo apt install nginx mysql-server redis-server certbot python3-certbot-nginx -y

PixelFed 基于 PHP 开发，需要安装 PHP 8.1 及以上版本及其扩展：

sudo apt install php8.1 php8.1-fpm php8.1-mysql php8.1-xml php8.1-gd php8.1-mbstring php8.1-curl php8.1-zip php8.1-bcmath php8.1-json php8.1-intl -y

安装和配置 PixelFed

1. 下载 PixelFed

进入 Web 目录并克隆官方仓库：

cd /var/www/sudo git clone https://github.com/pixelfed/pixelfed.gitcd pixelfedsudo chown -R www-data:www-data .

2. 安装依赖

使用 Composer 安装 PHP 依赖：

sudo cp .env.example .envsudo composer install --no-dev --optimize-autoloader

3. 配置数据库

登录 MySQL 并创建数据库和用户：

CREATE DATABASE pixelfed CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;CREATE USER 'pixelfed'@'localhost' IDENTIFIED BY 'your_strong_password';GRANT ALL PRIVILEGES ON pixelfed.* TO 'pixelfed'@'localhost';FLUSH PRIVILEGES;EXIT;

修改 .env 文件中的数据库配置：

DB_CONNECTION=mysqlDB_HOST=127.0.0.1DB_PORT=3306DB_DATABASE=pixelfedDB_USERNAME=pixelfedDB_PASSWORD=your_strong_password

4. 生成密钥并迁移数据

sudo php artisan key:generatesudo php artisan storage:linksudo php artisan migrate --force

5. 配置 Redis

编辑 .env 文件，将缓存驱动改为 Redis：

CACHE_DRIVER=redisSESSION_DRIVER=redisREDIS_HOST=127.0.0.1REDIS_PASSWORD=nullREDIS_PORT=6379

重启 Redis 服务：

sudo systemctl restart redis-server

配置 Nginx 和 HTTPS

创建 Nginx 配置文件 /etc/nginx/sites-available/pixelfed，内容如下：

server {    listen 80;    server_name yourdomain.com;    return 301 https://$server_name$request_uri;}server {    listen 443 ssl http2;    server_name yourdomain.com;    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;    root /var/www/pixelfed/public;    index index.php;    location / {        try_files $uri $uri/ /index.php?$query_string;    }    location ~ \.php$ {        include snippets/fastcgi-php.conf;        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;    }    location ~ /\.ht {        deny all;    }}

启用站点并申请 SSL 证书：

sudo ln -s /etc/nginx/sites-available/pixelfed /etc/nginx/sites-enabled/sudo certbot --nginx -d yourdomain.comsudo systemctl restart nginx

启动队列与定时任务

PixelFed 需要队列来处理后台任务。安装 Supervisor：

sudo apt install supervisor -ysudo nano /etc/supervisor/conf.d/pixelfed.conf

添加以下内容：

[program:pixelfed-worker]process_name=%(program_name)s_%(process_num)02dcommand=php /var/www/pixelfed/artisan queue:work --sleep=3 --tries=3 --max-time=3600autostart=trueautorestart=truestopasgroup=truekillasgroup=trueuser=www-datanumprocs=2redirect_stderr=truestdout_logfile=/var/www/pixelfed/storage/logs/worker.log

重启 Supervisor 并设置定时任务：

sudo supervisorctl rereadsudo supervisorctl updatesudo supervisorctl start allsudo crontab -e -u www-data

添加：

* * * * * php /var/www/pixelfed/artisan schedule:run >> /dev/null 2>&1

完成配置与测试

现在通过浏览器访问 https://yourdomain.com，即可看到 PixelFed 的配置向导。按照提示创建管理员账户、设置站点名称和描述即可完成初始化。你还可以在后台管理面板中配置注册策略、媒体上传限制等高级选项。

如果你在搭建过程中遇到任何问题，建议使用 Ciuic 云服务器 提供的技术支持和文档，其高性能 SSD 和稳定的网络环境能显著提升 Pixelfed 的运行效率。祝你在 PixelFed 的世界里畅享自主可控的图片社交体验！