项目介绍
Runtipi 提供应用目录和生命周期管理,适合在受支持的 Linux 主机中集中安装自托管服务。它不是给所有 NAS 型号都通用的安装包,系统、端口、架构与现有 Docker 环境都需要核对。
应用目录提供成套安装配置,平台管理启动、停止与更新,实际数据仍在对应目录。主机支持情况需要先核对。
适合受支持 Linux 环境集中管理服务。已有复杂 Docker 网络时先评估共存,不能当作所有 NAS 通用套件。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 应用目录 | 选择维护中的服务 |
| 生命周期 | 管理启动停止 |
| 配置入口 | 填写应用参数 |
| 更新流程 | 按平台版本迁移 |
| 数据管理 | 核对目录和备份 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | NAS 与运维 |
| 项目仓库 | runtipi/runtipi |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装与运行
在官方支持的 Linux 主机或 Linux 虚拟机安装,先准备空闲的 80/443 端口与持久化磁盘。DSM 不是 Runtipi 文档列出的标准 Linux 安装环境。
1. 安装和初始化
curl -fsSL https://setup.runtipi.io -o runtipi-setup.sh
less runtipi-setup.sh
sudo bash runtipi-setup.sh
2. 第一次使用
查看脚本后按 q 退出,再运行安装。安装器完成后按输出的入口创建管理账号,先安装一个轻量应用,检查应用目录、日志和停止恢复。安装器使用的项目目录与持久化目录都要保存,迁移前先备份。
只在自己选择的 Linux 主机执行这些命令。不要为了省步骤把 DSM 的 80/443 占用直接关闭;群晖场景先建立独立 Linux 虚拟机,让两个管理环境各用自己的地址。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。