不能直接用 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。

















