不能直接用 apt install seafile-server，因官方仓库版本严重滞后、缺失systemd模板且python依赖混乱，易报importerror或seaf-server not found；官方明确要求使用官网预编译tarball安装。
为什么不能直接用 apt install seafile-server
Debian/Ubuntu 官方仓库里的 seafile-server 包通常严重滞后（比如 Ubuntu 22.04 仍为 7.1.x，而当前稳定版已是 9.0.x），且缺失 systemd 服务模板、Python 依赖管理混乱，安装后大概率出现 ImportError: No module named 'django' 或 seaf-server not found。官方明确不推荐通过包管理器安装，必须用其提供的预编译 tarball。
下载并解压官方 tarball 的关键步骤
必须从 Seafile 官网下载页 获取对应架构的 seafile-server_<version>_x86-64.tar.gz</version>（不要选 source 或 docker 版）。解压后目录结构必须是：seafile-server-<version>/</version> 下直接包含 setup-seafile.sh、seafile.sh、seahub.sh 等脚本 —— 若解压出来多了一层文件夹（如 seafile-server-9.0.13/seafile-server-9.0.13/），说明你误下了 GitHub Actions 自动生成的构建包，会导致后续 ./setup-seafile.sh 找不到依赖路径。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 解压命令必须用
tar -zxvf seafile-server_*.tar.gz，不要加-C指定目录，避免路径嵌套 - 运行
setup-seafile.sh前，确保当前工作目录就是seafile-server-<version>/</version> - 脚本会创建
conf/、seafile-data/、logs/等子目录，这些路径后续不能移动或重命名，否则启动失败
MySQL 配置时最容易出错的三个点
Seafile 要求 MySQL 用户必须拥有 CREATE、DROP、SELECT、INSERT、UPDATE、DELETE 权限，且 host 不能设为 %（除非你明确需要远程连接）。常见错误现象是 setup-seafile.sh 卡在 “creating seafile database…” 后报 Access denied for user 'seafile'@'localhost'，其实是因为 root 登录后执行的 CREATE USER 语句没带 IDENTIFIED WITH mysql_native_password，导致新用户认证插件不兼容。
- 创建用户务必用：
CREATE USER 'seafile'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_strong_password'; - 授权后执行
FLUSH PRIVILEGES;，再退出 MySQL - 在
setup-seafile.sh中填数据库 host 时，写localhost，不要写127.0.0.1（二者在 MySQL socket 连接逻辑中行为不同）
systemd 服务文件必须手动编写且注意权限隔离
官方 tarball 不提供 systemd 单元文件，直接运行 ./seafile.sh start 和 ./seahub.sh start 只能前台运行，进程随终端关闭而终止。必须手写 /etc/systemd/system/seafile.service 和 /etc/systemd/system/seahub.service，且二者不能共用同一用户：Seafile 进程需以非 root 用户（如 seafile）运行，但该用户对 seafile-data/ 目录必须有读写权，而 seahub 是 Python Web 服务，需额外设置 Environment="PYTHONPATH=/path/to/seafile-server-9.0.13/seahub/thirdpart"，否则启动时报 ModuleNotFoundError: No module named 'PIL'。
-
seafile.service的User=和Group=必须与seafile-data/所有者一致 -
seahub.service的ExecStart必须完整指定 Python 解释器路径（如/usr/bin/python3），不能只写python - 启用前执行：
sudo chown -R seafile:seafile /opt/seafile/seafile-server-9.0.13/（假设安装在/opt/seafile）
sql_mode：Seafile 要求必须包含 STRICT_TRANS_TABLES，否则上传大文件时可能静默失败。检查命令是 mysql -u root -e "SELECT @@sql_mode;"，若缺失则需在 /etc/mysql/mysql.conf.d/mysqld.cnf 的 [mysqld] 段追加 sql_mode = STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION。
