Firefish 安装与维护手册
内容提要
本文介绍了在树莓派上安装和配置火鱼的步骤，包括安装依赖项、克隆仓库、配置数据库和网络设置，以及使用代理解析到域名。提供了实用技巧和注意事项。
延伸解读
树莓派安装的关键适配点
在树莓派等arm64设备上安装PostgreSQL时，需在软件源中显式添加arch=arm64，否则会报架构不支持错误。虽然忽略该错误也可能自动选择正确架构，但显式指定可避免潜在问题。此外，编译火鱼时需设置NODE_OPTIONS='--max-old-space-size=3072'，以应对树莓派有限的内存，防止构建过程因内存不足而失败。
编译与迁移的资源消耗
火鱼的编译和数据库迁移步骤耗时较长且占用大量存储空间。根据文章，编译后存储空间从8G逐步升至12G，迁移过程会输出大量SQL语句。建议在开始前确保树莓派有足够的存储余量，并预留充足时间，避免因空间不足或超时导致安装中断。
网络配置的两种路径
文章提供了两种网络配置方式：一是使用Caddy或Nginx进行反向代理，并配合ufw防火墙开放80和443端口；二是针对已使用cloudflared内网穿透的环境，只需将3000端口解析到域名即可，无需额外设置代理。读者应根据自身网络环境选择合适方案，避免重复配置。
升级与自定义的注意事项
升级火鱼前需关注“给管理员的建议”，并按照停止服务、拉取代码、重建、迁移、重启的流程操作。自定义方面，可通过./custom/assets/目录添加静态资产、自定义CSS和声音，修改后运行pnpm run gulp即可生效，无需重新编译。此外，可取消注释./custom/robots.txt中的规则来阻止爬虫索引。
Q&A
在树莓派上安装Firefish需要哪些依赖项？
需要的依赖项包括NodeJS V20、PostgreSQL V16、Redis V7、Nginx、FFmpeg、Rust 1.74、C/C++ 编译器和Python 3。
如何在树莓派上安装PostgreSQL？
使用命令：sudo apt install curl ca-certificates，添加软件源后，运行sudo apt update && sudo apt -y install postgresql-16。
如何配置Firefish的数据库？
创建角色和数据库，使用命令：sudo -u postgres createuser --no-createdb --no-createrole --no-superuser --encrypted --pwprompt firefish，随后创建数据库：sudo -u postgres createdb --encoding='UTF8' --owner=firefish firefish_db。
如何在树莓派上安装和配置Redis？
参考官网教程，使用命令：curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg，添加源后运行sudo apt-get update和sudo apt-get install redis。
如何使用Nginx进行Firefish的代理解析？
安装Nginx后，编辑配置文件，将反向代理设置为指向Firefish的运行端口，重启Nginx以应用更改。
Firefish的服务如何启动和管理？
创建systemd服务配置文件，使用命令sudo systemctl enable --now firefish启动服务。
