Ansible NAS
用 Ansible 和 Docker 自动化搭建家庭 NAS 和自托管应用，一劳永逸。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
用代码搭私有云，Ubuntu 一键变 NAS。
核心功能
- 一键自动化部署：只需一台 Ubuntu 服务器和 Ansible 即可自动安装 Docker 及数十个应用
- 应用市场丰富：支持 Plex、Nextcloud、Home Assistant、Jellyfin、Bitwarden 等 100+ 自托管服务
- 基础即代码：所有配置都在 Ansible 剧本中，可版本控制、重复使用，出问题可快速回滚
- 外部访问支持：通过域名和自动 DNS 更新，轻松从外网访问 NAS 服务
- 与 TrueNAS/FreeNAS 对比：更轻量、更灵活，不受厂商更新限制，完全自主可控
避坑指南
- •仅支持 Ubuntu 20.04/22.04 LTS，其他系统需自行调整,需要一定的 Ansible 和 Linux 基础知识，不适合纯小白,部分应用（如 GitLab）需要较大内存，建议至少 4GB RAM,自动 DNS 更新依赖 Cloudflare 等服务商，需提前准备好域名和 API 令牌,如果选择大量应用，首次部署时间可能较长（取决于网络和机器性能）
适用场景
- 在家庭服务器上一站式部署媒体服务器、云存储、密码管理器、智能家居中枢等服务
- 替代 FreeNAS/TrueNAS，获得更可控、更易维护的 NAS 系统
- 为开发或测试环境快速搭建自托管的 CI/CD、代码仓库、监控等工具
Ansible NAS 是一个基于 Ansible 的自动化部署工具，能将一台全新的 Ubuntu 服务器快速转变为功能完整的 NAS（网络附加存储）和自托管应用平台。它通过 Docker 容器自动安装和配置数十种流行应用——如 Plex、Nextcloud、Home Assistant、Jellyfin 等——让你拥有一个一致、可复现且易于维护的服务器环境。与 FreeNAS 等封闭系统不同，Ansible NAS 让你完全掌控每个组件，且由于只依赖标准 Ubuntu 和容器，可避免上游更新导致的兼容性问题。项目支持外部域名访问、自动 DNS 更新，并与 Traefik 等反向代理工具集成。非常适合希望通过基础设施即代码方式管理家庭服务器的极客用户。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤 1：在你的 Ubuntu 22.04+ 服务器上安装 Ansible（sudo apt install ansible）
步骤 2：克隆 Ansible NAS 仓库：git clone https://github.com/davestephens/ansible-nas.git && cd ansible-nas
步骤 3：复制配置模板：cp nas.yml.example nas.yml，然后编辑 nas.yml 选择要启用的应用和设置
- 步骤 1：在你的 Ubuntu 22.04+ 服务器上安装 Ansible（sudo apt install ansible）
- 步骤 2：克隆 Ansible NAS 仓库：git clone https://github.com/davestephens/ansible-nas.git && cd ansible-nas
- 步骤 3：复制配置模板：cp nas.yml.example nas.yml，然后编辑 nas.yml 选择要启用的应用和设置
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
由于所有服务都部署在 Docker 容器中，卸载只需停止并删除相关容器和镜像即可：docker stop $(docker ps -aq) && docker rm $(docker ps -aq) && docker system prune -a。若想彻底还原系统，可重装 Ubuntu。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
3 FAQs