不能直接用 apt 或 yum 安装 seafile，因官方源版本严重滞后（如 ubuntu 仍为 7.1.x，当前稳定版已超 12.0）、缺失 systemd 单元文件、python 依赖混乱，易报 importerror 或 seaf-server not found；官方明确要求仅使用官网预编译 tarball 安装。
别用 apt install seafile-server，它装出来大概率启动失败、缺模块、版本老旧——官方明确不支持包管理器安装，必须用官网预编译 tarball。
为什么不能直接 apt 或 yum 安装
Debian/Ubuntu 官方源里的 seafile-server 通常卡在 7.1.x（当前稳定版已是 12.0+），缺失 systemd 单元文件，Python 依赖错乱，常见报错包括：ImportError: No module named 'django'、seaf-server not found。CentOS/RHEL 的 EPEL 包同样滞后且未适配新版 MySQL 认证插件。官方文档反复强调：只认官网 tarball。
下载和解压 tarball 的关键细节
从 Seafile 官网下载页 获取 seafile-server_<version>_x86-64.tar.gz</version>（注意：不是 source、不是 docker、不是 GitHub Actions 构建包）。解压后目录结构必须是：seafile-server-<version>/</version> 下直接有 setup-seafile.sh、seafile.sh、seahub.sh 等脚本。
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 错误操作：执行
tar -zxvf ... -C /opt→ 多出一层嵌套路径，导致./setup-seafile.sh找不到自身位置 - 正确做法：在目标目录下直接运行
tar -zxvf seafile-server_*.tar.gz，不加-C - 验证：进入解压目录后，
ls -l应看到conf/、seafile-data/、logs/等子目录为空（脚本会自动创建）
MySQL 配置最容易卡住的三个点
setup-seafile-mysql.sh 在 “creating seafile database…” 步骤卡死，90% 是 MySQL 权限或连接配置问题：
- 用户必须用
CREATE USER 'seafile'@'localhost' IDENTIFIED WITH mysql_native_password BY 'xxx';创建 —— CentOS 7 默认用auth_socket插件，不兼容 - 授权语句必须包含
CREATE、DROP、SELECT、INSERT、UPDATE、DELETE，缺一不可 - 在脚本里填数据库 host 时写
localhost，不要写127.0.0.1（MySQL socket 连接逻辑不同，后者会失败） - 确认
/etc/my.cnf中没有skip-networking，且bind-address未强制为127.0.0.1
启动后局域网打不开？改 gunicorn.conf 和防火墙
默认 seahub 只监听 127.0.0.1:8000，其他机器访问 http://<server-ip>:8000</server-ip> 必然超时：
- 编辑
conf/gunicorn.conf，把bind = "127.0.0.1:8000"改成bind = "0.0.0.0:8000" - Ubuntu/Debian：执行
sudo ufw allow 8000 - CentOS/RHEL：执行
sudo firewall-cmd --permanent --add-port=8000/tcp && sudo firewall-cmd --reload - 改完重启服务：
./seafile.sh restart && ./seahub.sh restart
真正容易被忽略的是：所有路径（conf/、seafile-data/、logs/）一旦由 setup-seafile.sh 创建，就不能移动或重命名，否则 seafile.sh 启动时直接报错退出 —— 它硬编码读取这些相对路径。
