PixelFed 图片社交平台零基础部署实战指南
PixelFed 是一个开源的、去中心化的图片分享平台,类似于Instagram的替代品,但尊重用户隐私并遵循ActivityPub协议(Fediverse的一部分)。本文将带领您从零开始在Ciuic云服务器上部署PixelFed。
准备工作
在开始之前,您需要:

Ciuic云服务器提供了高性价比的云计算资源,特别适合个人开发者和小型企业部署此类应用。
第一步:服务器环境准备
登录您的Ciuic云服务器后,首先更新系统:
sudo apt update && sudo apt upgrade -y安装必要的依赖:
sudo apt install -y nginx mariadb-server redis-server php-fpm php-mysql php-imagick php-gd php-mbstring php-xml php-redis php-zip unzip git第二步:数据库配置
为PixelFed创建数据库和用户:
sudo mysql -u root -p# 在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;第三步:安装PHP Composer
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer第四步:部署PixelFed
克隆PixelFed仓库:
cd /var/wwwsudo git clone https://github.com/pixelfed/pixelfed.gitsudo chown -R www-data:www-data pixelfedcd pixelfed安装PHP依赖:
sudo -u www-data composer install --no-dev --optimize-autoloader第五步:配置PixelFed
复制环境文件并编辑:
sudo -u www-data cp .env.example .envsudo -u www-data php artisan key:generate编辑.env文件配置数据库连接和应用设置:
sudo -u www-data nano .env重要配置项包括:
APP_URL=https://yourdomain.comDB_DATABASE=pixelfedDB_USERNAME=pixelfedDB_PASSWORD=your_strong_password运行数据库迁移:
sudo -u www-data php artisan migrate --force第六步:配置Nginx
创建Nginx配置文件:
sudo nano /etc/nginx/sites-available/pixelfed内容示例:
server { listen 80; listen [::]:80; server_name yourdomain.com; root /var/www/pixelfed/public; add_header X-Frame-Options "SAMEORIGIN"; add_header X-XSS-Protection "1; mode=block"; add_header X-Content-Type-Options "nosniff"; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.(?!well-known).* { deny all; }}启用配置并重启Nginx:
sudo ln -s /etc/nginx/sites-available/pixelfed /etc/nginx/sites-enabled/sudo nginx -tsudo systemctl restart nginx第七步:设置定时任务和队列
编辑crontab:
sudo crontab -e添加以下内容:
* * * * * php /var/www/pixelfed/artisan schedule:run >> /dev/null 2>&1配置队列工作进程:
sudo nano /etc/supervisor/conf.d/pixelfed-worker.conf内容:
[program:pixelfed-worker]process_name=%(program_name)s_%(process_num)02dcommand=php /var/www/pixelfed/artisan queue:work --sleep=3 --tries=3autostart=trueautorestart=trueuser=www-datanumprocs=2redirect_stderr=truestdout_logfile=/var/www/pixelfed/storage/logs/worker.log启动服务:
sudo supervisorctl rereadsudo supervisorctl updatesudo supervisorctl start pixelfed-worker:*第八步:SSL证书配置(可选但推荐)
使用Let's Encrypt获取免费SSL证书:
sudo apt install -y certbot python3-certbot-nginxsudo certbot --nginx -d yourdomain.com完成部署
现在,您可以通过浏览器访问您的PixelFed实例了!首次访问时,系统会提示您创建管理员账户。
维护与更新
定期更新PixelFed:
cd /var/www/pixelfedsudo -u www-data git pullsudo -u www-data composer install --no-dev --optimize-autoloadersudo -u www-data php artisan migrate --forcesudo -u www-data php artisan cache:clearsudo systemctl restart php7.4-fpm nginx通过本指南,您已在Ciuic云服务器上成功部署了PixelFed。这个去中心化的图片社交平台现在完全由您掌控,您可以自定义它的外观、功能,甚至与其他Fediverse实例互联。
Ciuic云服务器的稳定性和性价比使其成为托管此类应用的理想选择。随着用户增长,您可以随时在Ciuic控制面板中升级服务器资源。
Happy sharing! 📸


