01 / 准备服务器。
选择操作系统及其版本,以安装 Docker Engine 和 Compose 插件。从项目维护者处获取当前 Sprutio 源代码,并进入其根目录。Docker Desktop 不提供对 macOS 或 Windows 系统账号的访问。
选择操作系统
先选择操作系统,再选择版本,即可查看安装命令。
Ubuntu
amd64 / arm64选择版本
Ubuntu 26.10 · Stonking
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '26.10' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: stonking
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Ubuntu 26.04 LTS · Resolute
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '26.04' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: resolute
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Ubuntu 24.04 LTS · Noble
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '24.04' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: noble
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Ubuntu 22.04 LTS · Jammy
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '22.04' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: jammy
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明CentOS
amd64 / arm64选择版本
CentOS Stream 10
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'centos' ] && [ "${sprutio_os_version%%.*}" = '10' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明CentOS Stream 9
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'centos' ] && [ "${sprutio_os_version%%.*}" = '9' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Debian
amd64 / arm64选择版本
Debian 13 · Trixie
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '13' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: trixie
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Debian 12 · Bookworm
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '12' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: bookworm
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Raspberry Pi OS
arm64请使用 64 位 Raspberry Pi OS。这些命令使用适用于 Debian arm64 的 Docker 官方软件源;此处不提供 32 位版本的安装说明。
选择版本
Raspberry Pi OS Trixie · arm64
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '13' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: trixie
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Raspberry Pi OS Bookworm · arm64
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '12' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: bookworm
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Fedora
amd64 / arm64选择版本
Fedora 44
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'fedora' ] && [ "$sprutio_os_version" = '44' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf5-plugins
dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明Fedora 43
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'fedora' ] && [ "$sprutio_os_version" = '43' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf5-plugins
dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明RHEL
amd64 / arm64请使用已注册且能够访问标准软件包仓库的 RHEL 系统。
选择版本
RHEL 10
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '10' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明RHEL 9
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '9' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明RHEL 8
请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '8' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。
Docker 官方安装说明02 / 构建并启动。
在包含 compose.yaml 的 Sprutio 源代码目录中,以 root 身份执行以下命令。应用将从源代码构建,并以 app 服务启动。
docker compose build
docker compose up -d03 / 检查应用。
查看服务状态和最近的日志。默认访问地址为 http://SERVER_IP:8080。输入登录凭据前,请将访问限制在可信网络内,或建立受保护的连接。
docker compose ps
docker compose logs --tail=100 app04 / 使用 Linux 账号登录。
输入 Linux 主机上的用户名和密码。账号必须设置密码并启用 Shell;锁定账号和空密码均不被接受。以 root 登录会获得 root 权限。主机文件挂载到 /host,文件操作以已认证用户的权限执行。
保护远程访问。
应用默认使用未加密的 HTTP。密码和会话需要受保护的网络通道。请使用可信网络或 SSH 隧道;公开部署时,在应用前配置并验证 HTTPS。本网站的 HTTPS 不会自动为你的文件管理器配置 HTTPS。
在重启后保留设置。
app_data 数据卷保存用户偏好和连接信息。请将它与配置一起备份;主机文件需要单独备份。以下命令用于停止和启动服务。更新时,获取经审查的源代码版本,重新构建并启动。仅在确实要清空数据时删除数据卷。
docker compose stop
docker compose start
