前段时间接了一个内网环境文件交换的活机房和外网完全隔离不能连 GitHub、不能拉 Docker 镜像所有软件都要靠移动介质送进去。项目里定的核心组件就是 SFTPGo 2.7.0一个用 Go 写的多功能文件传输服务同时支持 SFTP、FTP、WebDAV、HTTP 下载自带 Web 管理后台默认用嵌入式 SQLite 存配置编译产物基本是单个可执行文件。这个特性放到离线环境里非常舒服不用装数据库、不用装运行时、不用担心一堆动态库依赖解压就能跑。这篇指南主要面向两类人一类是要在隔离网络、等保内网、工控区这类环境里交付文件交换服务的运维另一类是自建 NAS 或者家里服务器被防火墙限制得比较死的折腾党。我会把整个离线部署链路拆开从外网机器怎么准备安装包、怎么校验到 Linux x86_64 裸机部署、ARM 设备、麒麟/OpenEuler 这类国产系统、Docker 内网导入再到初始化管理员、批量创建用户、汉化 Web 界面最后把常见坑都列一遍。内容完全基于 2.7.0 版本社区后续版本的资源不要直接拿过来混用。1. 项目概述与离线部署思路1.1 为什么离线环境优先选 SFTPGo离线部署最怕的不是软件本身而是依赖链。装一个 Nextcloud 要 PHP、数据库、Web 服务器装一个传统 FTP 服务虽然简单但管理界面基本靠改配置给几十个外部供应商开户能写到怀疑人生。SFTPGo 的优势在这里非常明显主程序是 Go 编译的静态二进制只要操作系统内核和 glibc 能跑解压就能启动不需要额外装 Python、Java、Node 之类的东西数据持久化默认走嵌入式 SQLite数据库这个最容易被离线环境卡住的环节直接省掉了。多协议支持也是实打实的价值。同一个进程可以同时开 SFTP、WebDAV、FTP、HTTP 服务不同用户甚至能限制只能用某一两种协议。这意味着原来一套线上一套线下的文件交换需求可以收敛成一个服务。我在实际项目里就用它替换了老旧的 vsftpd原来给外包公司开 FTP 账号要手动改配置、重启服务现在 Web 管理后台点两下就完事操作记录和登录审计也都齐了。1.2 离线部署的完整链路离线部署和在线部署最大区别在于所有操作都要提前设计好没法临时去外网补包。我习惯把整个流程分成五个阶段每个阶段都有明确产物外网准备机下载各架构的二进制包、Docker 镜像记录版本号和 sha256 校验值。校验与打包用 checksum 文件核对下载结果把二进制、配置文件、systemd 模板、初始化脚本整理成标准目录。介质传输通过 U 盘、内网文件服务器或光盘把打包目录送进隔离环境传输后再次校验哈希。目标机部署按操作系统和部署形态选择裸二进制、系统服务或 Docker 容器启动。配置与验证初始化管理员、创建虚拟用户、放行防火墙端口、用 SFTP 客户端实测上传下载。这里容易踩的第一个坑就是“下载完了直接拷贝”。离线环境下没有外网帮你纠错一个包的哈希不对可能要在内网排查半天。所以校验这步不能省后面会专门讲操作。1.3 多平台与部署形态怎么选SFTPGo 官方 release 对主流平台覆盖得很全常见的几种形态我都整理成了表格方便你出发之前对号入座目标环境架构安装包类型典型包名Linux 服务器x86_64tar.gz / rpm / debsftpgo_2.7.0_linux_x86_64.tar.gz鲲鹏、飞腾等 ARM 云平台arm64tar.gz / rpm / debsftpgo_2.7.0_linux_arm64.tar.gz树莓派、ARM 工控机armv7tar.gzsftpgo_2.7.0_linux_armv7.tar.gzWindows Serverx86_64zipsftpgo_2.7.0_windows_x86_64.zipFreeBSDx86_64tar.gzsftpgo_2.7.0_freebsd_x86_64.tar.gz部署形态方面我的原则是能跑裸二进制就不上 Docker除非目标环境已经强制用容器编排。原因很简单裸二进制占用的资源和排障复杂度都更低但如果你所在的内网环境里容器是标准交付方式Docker/docker-compose 路线也很成熟后面第三章会分别给方案。2. 离线资源准备外网下载与打包2.1 从 Release 页下载对应平台二进制外网准备机上第一件事是去 GitHub 的 SFTPGo release 页面找到 v2.7.0 这个 tag把需要用到的资产都下载下来。我通常会按平台拆开下载而不是只下载自己当前机器的包因为内网环境里往往既有 x86 服务器又有 ARM 机器一次出差把包都带齐省得来回跑。以 x86_64 的 Linux 服务器为例下载命令大概是这样的mkdir -p /opt/sftpgo-offline/bin cd /opt/sftpgo-offline/bin wget https://github.com/drakkan/sftpgo/releases/download/v2.7.0/sftpgo_2.7.0_linux_x86_64.tar.gz wget https://github.com/drakkan/sftpgo/releases/download/v2.7.0/sftpgo_2.7.0_linux_arm64.tar.gz wget https://github.com/drakkan/sftpgo/releases/download/v2.7.0/sftpgo_2.7.0_windows_x86_64.zip如果外网准备机通过 GitHub 下载速度不理想也可以从镜像站或企业内部代理拉取但要特别注意下载来源可以变校验值不能丢必须以官方 release 页面登记的哈希为准。下载完成后把每个包都放到单独的目录里并按平台命名方便后面打介质包。2.2 校验签名与一致性离线环境里没法临时比对哈希所以这一步必须在外网机做完。SFTPGo release 页面一般会附一个 checksums 文件把所有资产对应的 SHA-256 都列出来。下载后执行cd /opt/sftpgo-offline/bin sha256sum sftpgo_2.7.0_linux_x86_64.tar.gz然后和 checksums 文件里对应条目人工比对或者直接用sha256sum -c批量校验。批量校验时如果包很多建议过滤出真正需要的文件名再确认结果避免被一堆无关文件刷屏。校验通过之后才允许进入介质包。这个习惯是我踩过坑才养成的有一次从内网文件服务器拷贝外包结果 tar 包在传输中断过后自动续传出了坏块解压到一半报 CRC 错误现场重新走流程特别狼狈。现在我的介质包目录里一定包含 checksums 文件本身目标机部署前也要求执行一遍校验双保险。2.3 Docker 镜像离线导出如果内网环境走容器路线需要在准备机上提前把镜像拉下来并导出成 tar 文件。官方镜像名是drakkan/sftpgo标签对应版本docker pull drakkan/sftpgo:v2.7.0 docker save drakkan/sftpgo:v2.7.0 -o /opt/sftpgo-offline/images/sftpgo_v2.7.0_amd64.tar这里有个非常关键的细节docker save导出的是当前机器架构对应的镜像。在 x86 机器上拉取默认就是 amd64 的镜像拿到鲲鹏或飞腾的 ARM64 机器上docker load虽然能加载成功但运行时会直接报exec format error。解决办法有两个方向一是准备机上使用 buildx 拉取目标架构镜像docker pull --platform linux/arm64 drakkan/sftpgo:v2.7.0 docker save drakkan/sftpgo:v2.7.0 -o /opt/sftpgo-offline/images/sftpgo_v2.7.0_arm64.tar二是用docker manifest inspect docker.io/drakkan/sftpgo:v2.7.0先确认镜像支持的架构列表再决定拉哪种。我实践中更推荐第一种因为 manifest 模式在部分老版本 Docker 上可能不满足镜像仓库认证要求。tar 包一般几十 MBU 盘完全装得下不用追求压缩tar 本身就不适合再压一层。2.4 配置文件与辅助材料预整理离线环境有个隐性成本每输一条命令、每改一个文件都要比在线环境多花时间而且一旦改错参考资料也少。所以在外网准备阶段把配置文件、systemd 模板、初始化脚本全部打好包是性价比极高的事情。我常用的离线包目录结构是这样的sftpgo-offline/ ├── bin/ │ ├── sftpgo_2.7.0_linux_x86_64.tar.gz │ ├── sftpgo_2.7.0_linux_arm64.tar.gz │ └── sftpgo_2.7.0_windows_x86_64.zip ├── images/ │ ├── sftpgo_v2.7.0_amd64.tar │ └── sftpgo_v2.7.0_arm64.tar ├── config/ │ ├── sftpgo.json │ ├── sftpgo.service │ └── nssm-install.txt └── scripts/ ├── install_linux.sh └── create_users.sh配置文件用 JSON、YAML、TOML 都行SFTPGo 会自动识别我习惯用 JSON。准备阶段就把端口、日志级别、数据目录、时区这些关键项写好到了目标机只需要改少量路径和账号密码能减少很多现场操作失误。3. 多平台部署实操从 Linux 到 ARM 与 Docker3.1 Linux x86_64 裸二进制安装与 systemd 服务这是最常用的一套流程先演示一遍完整的 Linux 裸机安装。第一步解压到目标目录并创建专用系统用户tar zxvf sftpgo_2.7.0_linux_x86_64.tar.gz -C /opt/sftpgo useradd -r -d /var/lib/sftpgo -s /sbin/nologin sftpgo mkdir -p /etc/sftpgo /var/lib/sftpgo/home chown -R sftpgo:sftpgo /var/lib/sftpgo创建专用用户而不是直接跑 root是离线部署里最值得坚持的习惯。SFTPGo 本身支持非 root 运行用独立用户跑即使未来某个虚拟用户被攻破攻击者拿到的也只是 sftpgo 用户的权限而不是整台服务器。接下来把预先准备好的 sftpgo.json 放进/etc/sftpgo然后写 systemd 服务。[Unit] DescriptionSFTPGo Service Afternetwork-online.target Wantsnetwork-online.target [Service] Typesimple Usersftpgo Groupsftpgo ExecStart/opt/sftpgo/sftpgo serve -c /etc/sftpgo -d /var/lib/sftpgo Restarton-failure RestartSec5 LimitNOFILE65535 [Install] WantedBymulti-user.target-c指定配置目录-d指定数据目录。数据目录和配置目录分开很关键升级时只需要替换/opt/sftpgo里的二进制和/etc/sftpgo下的配置数据目录里的数据库和用户文件可以保留不动回滚也方便。启动后验证systemctl daemon-reload systemctl enable --now sftpgo curl http://127.0.0.1:8080/api/v2/version能返回版本号就说明服务已经起来了。3.2 麒麟/OpenEuler 环境的一次真实交付国产化系统现在遇到越来越多麒麟 V10 和 OpenEuler 22.03 本质上都是 Linux但有几个坑需要单独说。架构问题排第一。飞腾 FT2000 和鲲鹏 920 都是 ARM64必须下载linux_arm64的包如果下成 x86_64 包执行时会提示Exec format error。我在交付现场见过有人用file命令检查还没意识到问题其实file sftpgo输出里aarch64和x86-64一眼就能分辨。第二是防火墙差异。麒麟桌面版默认开了ufw服务器版用firewalldOpenEuler 默认 firewalld。放行端口命令firewall-cmd --permanent --add-port2022/tcp --add-port8080/tcp firewall-cmd --reload如果内网还开了 SELinux记得检查一下 SFTPGo 的数据目录上下文否则会出现“能看到进程但写不进文件”的诡异问题。用chcon -R -t usr_t /opt/sftpgo或者临时setenforce 0排查都行。第三是服务管理。麒麟和 OpenEuler 都支持 systemd我直接把上一小节的 unit 文件拷过去就能用。那套部署在飞腾麒麟环境里跑了大半年SFTP 和 WebDAV 同时开着内存占用不到 200MB非常稳定。3.3 ARM 设备与 Docker Compose 离线导入内网如果既有 x86 服务器又有 ARM 边缘设备Docker 路线需要特别注意架构匹配。先把对应架构的镜像 tar 包拷到目标机然后加载docker load -i sftpgo_v2.7.0_arm64.tar docker image ls | grep sftpgo接下来写一份最简单的docker-compose.ymlservices: sftpgo: image: drakkan/sftpgo:v2.7.0 container_name: sftpgo restart: unless-stopped ports: - 2022:2022 - 8080:8080 volumes: - ./sftpgo_data:/var/lib/sftpgo - ./sftpgo_config:/etc/sftpgo environment: - TZAsia/Shanghaidocker compose up -d就能启动。这里要强调一个离线环境特有的问题docker save只导出镜像本身不能再对已加载到本地的镜像做架构转换。如果内网机器是 ARM必须保证准备的 tar 包是 ARM 架构导出没有任何取巧空间。如果你的 ARM 设备是老式系统没有 systemd也没有碰巧装上 Docker那就走出最原始的路线解压 tar.gz用nohup /opt/sftpgo/sftpgo serve -c /etc/sftpgo -d /var/lib/sftpgo /var/log/sftpgo.log 21 启动开机自启可以挂到 rc.local。这种环境通常资源紧张建议只开放 SFTP 和 WebDAVWeb 管理界面按需开启。3.4 Windows 和 FreeBSD 补充部署Windows 部署相对简单解压 zip 后双击sftpgo.exe serve -c C:\sftpgo\config就能跑第一次启动 Windows 防火墙会弹窗询问是否允许监听要勾选“专用网络”允许。如果要用生产环境的标准做法推荐用 NSSM 把可执行文件注册成 Windows 服务nssm install sftpgo C:\sftpgo\sftpgo.exe serve -c C:\sftpgo\config nssm start sftpgoFreeBSD 的安装方式和 Linux 差不多下载freebsd_x86_64包解压用service或 rc 脚本管理这里不展开。macOS 用户理论上也能用类似手法跑本地 SFTP 服务但生产环境很少见我就不多说了。4. 初始化配置、Web 管理与汉化技巧4.1 首次启动与管理后台初始化服务启动后浏览器访问http://目标机IP:8080第一次打开会进入初始化页面需要设置管理员账号、密码和时区。这一步不能跳过否则 API 和数据管理功能
SFTPGo 2.7离线部署实战：内网隔离环境下的多平台文件交换方案
前段时间接了一个内网环境文件交换的活机房和外网完全隔离不能连 GitHub、不能拉 Docker 镜像所有软件都要靠移动介质送进去。项目里定的核心组件就是 SFTPGo 2.7.0一个用 Go 写的多功能文件传输服务同时支持 SFTP、FTP、WebDAV、HTTP 下载自带 Web 管理后台默认用嵌入式 SQLite 存配置编译产物基本是单个可执行文件。这个特性放到离线环境里非常舒服不用装数据库、不用装运行时、不用担心一堆动态库依赖解压就能跑。这篇指南主要面向两类人一类是要在隔离网络、等保内网、工控区这类环境里交付文件交换服务的运维另一类是自建 NAS 或者家里服务器被防火墙限制得比较死的折腾党。我会把整个离线部署链路拆开从外网机器怎么准备安装包、怎么校验到 Linux x86_64 裸机部署、ARM 设备、麒麟/OpenEuler 这类国产系统、Docker 内网导入再到初始化管理员、批量创建用户、汉化 Web 界面最后把常见坑都列一遍。内容完全基于 2.7.0 版本社区后续版本的资源不要直接拿过来混用。1. 项目概述与离线部署思路1.1 为什么离线环境优先选 SFTPGo离线部署最怕的不是软件本身而是依赖链。装一个 Nextcloud 要 PHP、数据库、Web 服务器装一个传统 FTP 服务虽然简单但管理界面基本靠改配置给几十个外部供应商开户能写到怀疑人生。SFTPGo 的优势在这里非常明显主程序是 Go 编译的静态二进制只要操作系统内核和 glibc 能跑解压就能启动不需要额外装 Python、Java、Node 之类的东西数据持久化默认走嵌入式 SQLite数据库这个最容易被离线环境卡住的环节直接省掉了。多协议支持也是实打实的价值。同一个进程可以同时开 SFTP、WebDAV、FTP、HTTP 服务不同用户甚至能限制只能用某一两种协议。这意味着原来一套线上一套线下的文件交换需求可以收敛成一个服务。我在实际项目里就用它替换了老旧的 vsftpd原来给外包公司开 FTP 账号要手动改配置、重启服务现在 Web 管理后台点两下就完事操作记录和登录审计也都齐了。1.2 离线部署的完整链路离线部署和在线部署最大区别在于所有操作都要提前设计好没法临时去外网补包。我习惯把整个流程分成五个阶段每个阶段都有明确产物外网准备机下载各架构的二进制包、Docker 镜像记录版本号和 sha256 校验值。校验与打包用 checksum 文件核对下载结果把二进制、配置文件、systemd 模板、初始化脚本整理成标准目录。介质传输通过 U 盘、内网文件服务器或光盘把打包目录送进隔离环境传输后再次校验哈希。目标机部署按操作系统和部署形态选择裸二进制、系统服务或 Docker 容器启动。配置与验证初始化管理员、创建虚拟用户、放行防火墙端口、用 SFTP 客户端实测上传下载。这里容易踩的第一个坑就是“下载完了直接拷贝”。离线环境下没有外网帮你纠错一个包的哈希不对可能要在内网排查半天。所以校验这步不能省后面会专门讲操作。1.3 多平台与部署形态怎么选SFTPGo 官方 release 对主流平台覆盖得很全常见的几种形态我都整理成了表格方便你出发之前对号入座目标环境架构安装包类型典型包名Linux 服务器x86_64tar.gz / rpm / debsftpgo_2.7.0_linux_x86_64.tar.gz鲲鹏、飞腾等 ARM 云平台arm64tar.gz / rpm / debsftpgo_2.7.0_linux_arm64.tar.gz树莓派、ARM 工控机armv7tar.gzsftpgo_2.7.0_linux_armv7.tar.gzWindows Serverx86_64zipsftpgo_2.7.0_windows_x86_64.zipFreeBSDx86_64tar.gzsftpgo_2.7.0_freebsd_x86_64.tar.gz部署形态方面我的原则是能跑裸二进制就不上 Docker除非目标环境已经强制用容器编排。原因很简单裸二进制占用的资源和排障复杂度都更低但如果你所在的内网环境里容器是标准交付方式Docker/docker-compose 路线也很成熟后面第三章会分别给方案。2. 离线资源准备外网下载与打包2.1 从 Release 页下载对应平台二进制外网准备机上第一件事是去 GitHub 的 SFTPGo release 页面找到 v2.7.0 这个 tag把需要用到的资产都下载下来。我通常会按平台拆开下载而不是只下载自己当前机器的包因为内网环境里往往既有 x86 服务器又有 ARM 机器一次出差把包都带齐省得来回跑。以 x86_64 的 Linux 服务器为例下载命令大概是这样的mkdir -p /opt/sftpgo-offline/bin cd /opt/sftpgo-offline/bin wget https://github.com/drakkan/sftpgo/releases/download/v2.7.0/sftpgo_2.7.0_linux_x86_64.tar.gz wget https://github.com/drakkan/sftpgo/releases/download/v2.7.0/sftpgo_2.7.0_linux_arm64.tar.gz wget https://github.com/drakkan/sftpgo/releases/download/v2.7.0/sftpgo_2.7.0_windows_x86_64.zip如果外网准备机通过 GitHub 下载速度不理想也可以从镜像站或企业内部代理拉取但要特别注意下载来源可以变校验值不能丢必须以官方 release 页面登记的哈希为准。下载完成后把每个包都放到单独的目录里并按平台命名方便后面打介质包。2.2 校验签名与一致性离线环境里没法临时比对哈希所以这一步必须在外网机做完。SFTPGo release 页面一般会附一个 checksums 文件把所有资产对应的 SHA-256 都列出来。下载后执行cd /opt/sftpgo-offline/bin sha256sum sftpgo_2.7.0_linux_x86_64.tar.gz然后和 checksums 文件里对应条目人工比对或者直接用sha256sum -c批量校验。批量校验时如果包很多建议过滤出真正需要的文件名再确认结果避免被一堆无关文件刷屏。校验通过之后才允许进入介质包。这个习惯是我踩过坑才养成的有一次从内网文件服务器拷贝外包结果 tar 包在传输中断过后自动续传出了坏块解压到一半报 CRC 错误现场重新走流程特别狼狈。现在我的介质包目录里一定包含 checksums 文件本身目标机部署前也要求执行一遍校验双保险。2.3 Docker 镜像离线导出如果内网环境走容器路线需要在准备机上提前把镜像拉下来并导出成 tar 文件。官方镜像名是drakkan/sftpgo标签对应版本docker pull drakkan/sftpgo:v2.7.0 docker save drakkan/sftpgo:v2.7.0 -o /opt/sftpgo-offline/images/sftpgo_v2.7.0_amd64.tar这里有个非常关键的细节docker save导出的是当前机器架构对应的镜像。在 x86 机器上拉取默认就是 amd64 的镜像拿到鲲鹏或飞腾的 ARM64 机器上docker load虽然能加载成功但运行时会直接报exec format error。解决办法有两个方向一是准备机上使用 buildx 拉取目标架构镜像docker pull --platform linux/arm64 drakkan/sftpgo:v2.7.0 docker save drakkan/sftpgo:v2.7.0 -o /opt/sftpgo-offline/images/sftpgo_v2.7.0_arm64.tar二是用docker manifest inspect docker.io/drakkan/sftpgo:v2.7.0先确认镜像支持的架构列表再决定拉哪种。我实践中更推荐第一种因为 manifest 模式在部分老版本 Docker 上可能不满足镜像仓库认证要求。tar 包一般几十 MBU 盘完全装得下不用追求压缩tar 本身就不适合再压一层。2.4 配置文件与辅助材料预整理离线环境有个隐性成本每输一条命令、每改一个文件都要比在线环境多花时间而且一旦改错参考资料也少。所以在外网准备阶段把配置文件、systemd 模板、初始化脚本全部打好包是性价比极高的事情。我常用的离线包目录结构是这样的sftpgo-offline/ ├── bin/ │ ├── sftpgo_2.7.0_linux_x86_64.tar.gz │ ├── sftpgo_2.7.0_linux_arm64.tar.gz │ └── sftpgo_2.7.0_windows_x86_64.zip ├── images/ │ ├── sftpgo_v2.7.0_amd64.tar │ └── sftpgo_v2.7.0_arm64.tar ├── config/ │ ├── sftpgo.json │ ├── sftpgo.service │ └── nssm-install.txt └── scripts/ ├── install_linux.sh └── create_users.sh配置文件用 JSON、YAML、TOML 都行SFTPGo 会自动识别我习惯用 JSON。准备阶段就把端口、日志级别、数据目录、时区这些关键项写好到了目标机只需要改少量路径和账号密码能减少很多现场操作失误。3. 多平台部署实操从 Linux 到 ARM 与 Docker3.1 Linux x86_64 裸二进制安装与 systemd 服务这是最常用的一套流程先演示一遍完整的 Linux 裸机安装。第一步解压到目标目录并创建专用系统用户tar zxvf sftpgo_2.7.0_linux_x86_64.tar.gz -C /opt/sftpgo useradd -r -d /var/lib/sftpgo -s /sbin/nologin sftpgo mkdir -p /etc/sftpgo /var/lib/sftpgo/home chown -R sftpgo:sftpgo /var/lib/sftpgo创建专用用户而不是直接跑 root是离线部署里最值得坚持的习惯。SFTPGo 本身支持非 root 运行用独立用户跑即使未来某个虚拟用户被攻破攻击者拿到的也只是 sftpgo 用户的权限而不是整台服务器。接下来把预先准备好的 sftpgo.json 放进/etc/sftpgo然后写 systemd 服务。[Unit] DescriptionSFTPGo Service Afternetwork-online.target Wantsnetwork-online.target [Service] Typesimple Usersftpgo Groupsftpgo ExecStart/opt/sftpgo/sftpgo serve -c /etc/sftpgo -d /var/lib/sftpgo Restarton-failure RestartSec5 LimitNOFILE65535 [Install] WantedBymulti-user.target-c指定配置目录-d指定数据目录。数据目录和配置目录分开很关键升级时只需要替换/opt/sftpgo里的二进制和/etc/sftpgo下的配置数据目录里的数据库和用户文件可以保留不动回滚也方便。启动后验证systemctl daemon-reload systemctl enable --now sftpgo curl http://127.0.0.1:8080/api/v2/version能返回版本号就说明服务已经起来了。3.2 麒麟/OpenEuler 环境的一次真实交付国产化系统现在遇到越来越多麒麟 V10 和 OpenEuler 22.03 本质上都是 Linux但有几个坑需要单独说。架构问题排第一。飞腾 FT2000 和鲲鹏 920 都是 ARM64必须下载linux_arm64的包如果下成 x86_64 包执行时会提示Exec format error。我在交付现场见过有人用file命令检查还没意识到问题其实file sftpgo输出里aarch64和x86-64一眼就能分辨。第二是防火墙差异。麒麟桌面版默认开了ufw服务器版用firewalldOpenEuler 默认 firewalld。放行端口命令firewall-cmd --permanent --add-port2022/tcp --add-port8080/tcp firewall-cmd --reload如果内网还开了 SELinux记得检查一下 SFTPGo 的数据目录上下文否则会出现“能看到进程但写不进文件”的诡异问题。用chcon -R -t usr_t /opt/sftpgo或者临时setenforce 0排查都行。第三是服务管理。麒麟和 OpenEuler 都支持 systemd我直接把上一小节的 unit 文件拷过去就能用。那套部署在飞腾麒麟环境里跑了大半年SFTP 和 WebDAV 同时开着内存占用不到 200MB非常稳定。3.3 ARM 设备与 Docker Compose 离线导入内网如果既有 x86 服务器又有 ARM 边缘设备Docker 路线需要特别注意架构匹配。先把对应架构的镜像 tar 包拷到目标机然后加载docker load -i sftpgo_v2.7.0_arm64.tar docker image ls | grep sftpgo接下来写一份最简单的docker-compose.ymlservices: sftpgo: image: drakkan/sftpgo:v2.7.0 container_name: sftpgo restart: unless-stopped ports: - 2022:2022 - 8080:8080 volumes: - ./sftpgo_data:/var/lib/sftpgo - ./sftpgo_config:/etc/sftpgo environment: - TZAsia/Shanghaidocker compose up -d就能启动。这里要强调一个离线环境特有的问题docker save只导出镜像本身不能再对已加载到本地的镜像做架构转换。如果内网机器是 ARM必须保证准备的 tar 包是 ARM 架构导出没有任何取巧空间。如果你的 ARM 设备是老式系统没有 systemd也没有碰巧装上 Docker那就走出最原始的路线解压 tar.gz用nohup /opt/sftpgo/sftpgo serve -c /etc/sftpgo -d /var/lib/sftpgo /var/log/sftpgo.log 21 启动开机自启可以挂到 rc.local。这种环境通常资源紧张建议只开放 SFTP 和 WebDAVWeb 管理界面按需开启。3.4 Windows 和 FreeBSD 补充部署Windows 部署相对简单解压 zip 后双击sftpgo.exe serve -c C:\sftpgo\config就能跑第一次启动 Windows 防火墙会弹窗询问是否允许监听要勾选“专用网络”允许。如果要用生产环境的标准做法推荐用 NSSM 把可执行文件注册成 Windows 服务nssm install sftpgo C:\sftpgo\sftpgo.exe serve -c C:\sftpgo\config nssm start sftpgoFreeBSD 的安装方式和 Linux 差不多下载freebsd_x86_64包解压用service或 rc 脚本管理这里不展开。macOS 用户理论上也能用类似手法跑本地 SFTP 服务但生产环境很少见我就不多说了。4. 初始化配置、Web 管理与汉化技巧4.1 首次启动与管理后台初始化服务启动后浏览器访问http://目标机IP:8080第一次打开会进入初始化页面需要设置管理员账号、密码和时区。这一步不能跳过否则 API 和数据管理功能