宝塔面板 Pixelfed 部署指南：图文详解，快速搭建你的去中心化社交网络

官方文档
https://docs.pixelfed.org/running-pixelfed/installation.html

先决条件
apache nginx
php8.1
mysql5.7
redis7

宝塔面板里这些都可以提前安装好

添加网站申请好SSL

禁中php函数
putenv
symlink()
proc_open
pcntl_signal

ssh连后cd网站目录以下命令拉仓库

1
git clone -b dev https://github.com/pixelfed/pixelfed.git pixelfed

拉取上一个版本(可选)最新的版本有很多BUG v0.11.12是版本号可以在作者github查看

1
git clone -b v0.11.12 https://github.com/pixelfed/pixelfed.git pixelfed

给用户和目录权限

1
cd pixelfed
2
sudo chown -R www:www .
3
sudo find . -type d -exec chmod 755 {} \;
4
sudo find . -type f -exec chmod 644 {} \;

提前安装好composer

1
curl -sS https://getcomposer.org/installer | php
2
mv composer.phar /usr/bin/composer

以下命令会自动安装需要的依赖

1
composer install --no-ansi --no-interaction --optimize-autoloader

官司文档里，让复制.env.example改名.env

1
cp .env.example .env

但是最新版没有这个档案
从这里复制.env.example全部内容替换.env里的全部内容
https://github.com/pixelfed/pixelfed/blob/v0.11.12/.env.example
将数据库域名 redis的密码都配置好后执行以下命令

生成APP_KEY

1
php artisan key:generate

链接到应用程序目录

1
php artisan storage:link

导入数据库

1
php artisan migrate --force

启用对位置数据的支持

1
php artisan import:cities

如果在.env里启用了ActivityPub

1
php artisan instance:actor

如果在.env启用了 OAuth

1
php artisan passport:keys

缓存路由

1
php artisan route:cache
2
php artisan view:cache

每次改.env需要执行一次

1
php artisan config:cache

编辑网站配置文件将目录后面加上/public

这个时候应该是可以通过域名访问网站了注册一个帐户先
用以下命令提升帐号为管理员

1
php artisan user:admin 帐号

1
php artisan horizon:install
2
php artisan horizon:publish

以下二选一
1.去这个目录
/etc/systemd/system/
添加新建档案pixelfed.service
复制以下内容粘上

1
[Unit]
2
Description=Pixelfed task queueing via Laravel Horizon
3
After=network.target
4
Requires=mysqld.service
5
Requires=php-fpm-81.service
6
Requires=redis.service
7
Requires=httpd.service
8

9
[Service]
10
Type=simple
11
ExecStart=/usr/bin/php /www/wwwroot/你的域名/pixelfed/artisan horizon
12
User=www
13
Restart=on-failure
14

15
[Install]
16
WantedBy=multi-user.target

1
sudo -u www /usr/bin/php /www/wwwroot/你的域名/pixelfed/artisan horizon

1
sudo systemctl daemon-reload
2
sudo systemctl start pixelfed
3
sudo systemctl status pixelfed

1
sudo systemctl enable --now pixelfed

2.安装Supervisor
Name填pixefled
Run User选www
Start command填

1
php artisan horizon

Process directory选网站目录/www/wwwroot/域名pixelfed
Processes填 1
保存

运行

1
php artisan package:discoveror

1
composer install

然后运行

1
php artisan horizon:install

1
php artisan route:cache

最差最后一步二选一
1

1
crontab -e

最后一行添加

1
* * * * * /usr/bin/php /www/wwwroot/你的域名/pixelfed/artisan schedule:run >> /dev/null 2>&1

保存后选择以下命令来确认

1
crontab -l

2宝塔面板添加计划任务

1
/usr/bin/php /www/wwwroot/域名/pixelfed/artisan schedule:run

设定每1分钟运行一次

到此结束

关于更新

1
cd /pixelfed 安装目录
2
git reset --hard HEAD
3
git pull origin dev
4
composer install
5
php artisan config:cache
6
php artisan route:cache
7
php artisan migrate --force

清除配置缓存

1
php artisan config:clear

清除应用缓存

1
php artisan cache:clear

重启 Redis 服务（确保 Redis 配置正确）

1
systemctl restart redis