GoodSync 中文文档 下载 App

GoodSync for Linux 安装、daemon 与 Docker 部署

支持的 Linux 发行版

GoodSync 官方主动测试以下发行版，其他发行版可能兼容但不保证：

架构支持 x86_64、arm64（包括 Raspberry Pi 4+ 的 64 位系统）。

命令行安装

GoodSync Linux 版通过官网下载的安装脚本一键完成：

# 下载最新版安装脚本
curl -O https://www.goodsync.com/download/goodsync-v12-linux-x86_64.tar.gz
tar -xzf goodsync-v12-linux-x86_64.tar.gz
# 解压后运行安装脚本
sudo ./install-gssh

# arm64 架构（如 Raspberry Pi）
curl -O https://www.goodsync.com/download/goodsync-v12-linux-aarch64.tar.gz
tar -xzf goodsync-v12-linux-aarch64.tar.gz
sudo ./install-gssh

安装完成后 GoodSync 会被安装到 /usr/local/bin/goodsync 和 /usr/local/bin/gsync（命令行工具）。

systemd daemon 注册

对于需要长期运行同步任务的 Linux 服务器，推荐将 GoodSync 注册为 systemd daemon：

# 创建 systemd 服务文件
sudo tee /etc/systemd/system/goodsync.service << 'EOF'
[Unit]
Description=GoodSync Sync Service
After=network-online.target

[Service]
Type=forking
ExecStart=/usr/local/bin/goodsync --daemon
ExecStop=/usr/local/bin/goodsync --shutdown
User=goodsync
Group=goodsync
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

# 创建专用运行用户
sudo useradd -r -s /usr/sbin/nologin goodsync

# 启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable goodsync
sudo systemctl start goodsync

# 查看状态
sudo systemctl status goodsync

Docker 容器化部署

GoodSync 没有官方 Docker 镜像，但可以基于 Ubuntu 或 Alpine 自行构建：

# 基于 Ubuntu 的 GoodSync 容器示例
FROM ubuntu:22.04

RUN apt-get update && apt-get install -y curl wget ca-certificates

# 下载并安装 GoodSync
RUN curl -L https://www.goodsync.com/download/goodsync-v12-linux-x86_64.tar.gz | tar xz && \
    cd goodsync-v12-linux-x86_64 && ./install-gssh

# 复制你的 GoodSync 配置和作业文件
COPY goodsync-config/ /root/.goodsync/

# 同步数据的卷需要在 docker run 时挂载
# -v /host/data:/container/data

ENTRYPOINT ["gsync"]
CMD ["--daemon"]

命令行工具 gsync 的基本用法

Linux 版没有图形界面，作业管理通过 gsync 命令行完成：

# 列出所有作业
gsync list

# 运行指定作业
gsync run JobName

# 查看作业运行状态
gsync status JobName

# 查看同步日志
gsync log JobName

# 导入/导出作业配置
gsync export JobName -o backup.gs
gsync import backup.gs

作业配置文件格式为 .gs 后缀的 XML，也可以通过 Windows/macOS 版创建后导出到 Linux 上使用。

注意事项