准备系统和数据盘
先更新系统并确认架构、磁盘空间和局域网地址。正式数据最好挂载到独立目录，例如 /srv/webcool-data，不要长期依赖临时目录或未经确认的移动磁盘挂载点。
uname -m
df -h
ip address如果准备让服务监听所有局域网接口，应确认机器位于可信网络中，并使用防火墙限制来源。互联网远程访问建议放在VPN或经过严格配置的HTTPS反向代理之后。
安装DEB主包
下载对应架构的安装包
从下载页获取Ubuntu/Debian AMD64安装包。ARM设备需要等待或选择明确提供的ARM64包，不要在架构不匹配时强制安装。
安装软件包
进入下载目录，使用dpkg安装。文件名应以实际下载版本为准。
sudo dpkg -i webcool_2.0.0-1_amd64.deb
sudo apt-get -f install了解安装目录
主程序通常安装到 /opt/soft/webcool，启动入口为 /usr/local/bin/webcool，配置文件位于 /opt/soft/webcool/conf/webcool.cf。静态页面、ffmpeg和SQLite运行库随主包放置在相应子目录。
启动服务
在测试阶段可显式指定监听地址和端口：
webcool -s 0.0.0.0:8080 -D长期运行时应结合安装包提供的配置与服务管理方式，并在变更前备份配置文件。
设置数据目录与权限
如果使用自定义数据目录，先创建专用路径，并确保运行webcool的账号拥有所需读写权限。不要为了省事对目录设置全局可写权限。
sudo mkdir -p /srv/webcool-data
sudo chown -R <运行用户>:<运行组> /srv/webcool-data
sudo chmod 750 /srv/webcool-data挂载外部磁盘时应使用稳定的UUID配置，并确认重启后挂载点仍然存在。若服务在磁盘未挂载时启动，可能把数据误写到系统盘同名目录。
限制网络访问
使用UFW时，可以只允许家庭网段访问8080端口。下面的网段只是示例，应替换为自己的局域网：
sudo ufw allow from 192.168.1.0/24 to any port 8080 proto tcp
sudo ufw status在另一台设备访问 http://服务器IP:8080，验证登录、上传和预览。若使用反向代理提供HTTPS，应同时配置正确的主机名、证书、上传大小和超时，尤其是大视频文件。
主包与AI组件如何选择
普通文件管理、预览、视频转码和基础编辑使用主包即可。AI图片超分、视频增强、CodeFormer人脸修复、Restormer去模糊或自动去红眼需要额外的AI运行组件与模型。先把文件管理服务稳定运行，再按机器性能和实际需求安装AI包。
性能建议：AI处理会消耗较多CPU、GPU、内存和磁盘临时空间。先用副本和小尺寸素材测试，避免在备份或大量上传期间同时启动多个重任务。
日常运维清单
- 定期安装Ubuntu安全更新和webcool新版本；
- 监控数据盘容量、inode、温度和SMART状态；
- 备份配置、用户数据和重要SQLite状态文件；
- 检查失败任务、异常登录和服务日志；
- 每季度至少演练一次从备份恢复文件；
- 升级前记录当前版本并保留可回退安装包。
常见问题
安装后命令找不到怎么办？
检查 /usr/local/bin/webcool 是否存在，并确认安装过程没有报错。也可以查看dpkg的软件包状态和安装日志。
服务能启动但网页打不开怎么办？
检查监听地址、端口占用、UFW规则和路由连通性。先从服务器本机访问，再逐步排查局域网访问。
可以直接使用root运行吗？
长期运行不推荐。应使用权限受限的专用账号，并仅授予数据目录和必需资源的访问权限。