https://github.com/kekylin/debian-homenas
一个将Debian/Ubuntu系统快速配置成准NAS系统的脚本。
https://github.com/kekylin/debian-homenas
debian homeassistant homelab homenas homepage openmediavault proxmox shell synology truenas ubuntu unraid
Last synced: about 1 month ago
JSON representation
一个将Debian/Ubuntu系统快速配置成准NAS系统的脚本。
- Host: GitHub
- URL: https://github.com/kekylin/debian-homenas
- Owner: kekylin
- License: gpl-3.0
- Created: 2024-04-26T10:57:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-10T12:55:43.000Z (about 2 months ago)
- Last Synced: 2025-05-10T13:42:28.916Z (about 2 months ago)
- Topics: debian, homeassistant, homelab, homenas, homepage, openmediavault, proxmox, shell, synology, truenas, ubuntu, unraid
- Language: Shell
- Homepage: https://kekylin.github.io/debnas-docs/
- Size: 689 KB
- Stars: 758
- Watchers: 11
- Forks: 91
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
基于Debian搭建HomeNAS
一个将Debian系统快速配置成准NAS系统的脚本。可视化WebUI操作界面，可以轻松实现文件共享、照片备份、家庭影音、管理Docker、管理虚拟机、建立RAID等功能，使得Debian系统能够高效稳定地承担NAS任务。
## 主要特性
- 开源
- 安全
- 稳定
- 高效
- 自由
---
## 成果展示
硬件为华擎-J3455，16G内存。底层系统为Debian，起了一台虚拟群晖和36个容器服务，CPU日常使用率30%左右，硬件利用率非常高。
#### [更多搭建成果展示图（点此打开查看）](https://kekylin.github.io/debnas-docs/guide/achievement/)
---
## 支持系统
Debian-12.x-amd64
Ubuntu 24.04 LTS-amd64
## 使用文档
[DebNAS文档](https://kekylin.github.io/debnas-docs/ "DebNAS文档")
## 快速开始
### 1、安装系统
[Debian系统最小化安装教程](https://kekylin.github.io/debnas-docs/guide/debian-minimal-installation/)
[Ubuntu系统最小化安装教程](https://kekylin.github.io/debnas-docs/guide/ubuntu-minimal-installation/)
### 2、连接系统
系统安装完成后，使用SSH工具连接上系统，输入下面运行脚本命令开启脚本。
> 注意：
> 1、Debian默认禁止root账户直接通过SSH连接，所以用安装系统时创建的第一个普通用户账号进行登录。
> 2、登陆后，必须使用以下命令切换到root账户运行脚本。
> 3、对于Ubuntu系统，不需先切换root账号，直接运行脚本命令即可。
```shell
su -
```
### 3、运行脚本
运行脚本前，建议先阅读[脚本介绍](https://kekylin.github.io/debnas-docs/guide/script-introduction/)，了解脚本能做什么先，脚本中的选项可以按需执行。运行脚本命令（二选一）
Github地址
```shell
SUDO=$(command -v sudo); ${SUDO:-} bash -c "bash <(wget -O- https://raw.githubusercontent.com/kekylin/Debian-HomeNAS/refs/heads/main/Shell/homenas.sh) -s github"
```
Gitee地址（国内用户推荐）
```shell
SUDO=$(command -v sudo); ${SUDO:-} bash -c "bash <(wget -O- https://gitee.com/kekylin/Debian-HomeNAS/raw/main/Shell/homenas.sh) -s gitee"
```
### 4、登陆使用
> **脚本执行完毕后，查看SSH工具显示的Cockpit面板管理地址和Docker管理工具地址，打开对应服务进行使用。**
Cockpit
一个基于 Web 的服务器图形界面，在 Web 浏览器中查看您的服务器并使用鼠标执行系统任务。启动容器、管理存储、配置网络和检查日志都很容易。基本上，您可以将 Cockpit 视为图形“桌面界面”。
Cockpit是直接使用系统账户进行登陆使用，出于安全考虑，Cockpit默认禁用root账户登陆，建议使用您安装系统时创建的第一个用户登陆。
```shell
https://localhost:9090
```
Portainer
一个Docker的可视化工具，可提供一个交互界面显示Docker的详细信息供用户操作。功能包括状态显示、应用模板快速部署、容器镜像网络数据卷的基本操作（包括上传下载镜像，创建容器等操作）、事件日志显示、容器控制台操作、Swarm集群和服务等集中管理和操作、登录用户管理和控制等功能。
```shell
https://localhost:9443
```
教程汇总(点我展开)
欢迎阅读本项目。在此，我想对本项目的内容做出以下免责声明：
1、内容来源： 本项目的内容主要来源于互联网，以及我个人在学习和探索过程中的知识总结。我会尽可能保证内容的准确性和可靠性，但不对信息的完整性和及时性做出任何担保。
2、版权保护： 本项目的所有原创内容均采用 CC BY 4.0 许可协议。欢迎个人或非商业性使用者在遵守此协议的前提下引用或转载内容。转载时请注明出处并附上项目的链接。对于任何形式的商业使用或修改内容，须在遵守该许可协议的同时保留原作者信息并注明来源。
3、内容时效性： 鉴于技术和知识的发展迅速，本项目中的一些内容可能会随着时间的推移而失去实用性或准确性。我会尽力更新和修订内容，以保持其新鲜和准确，但无法对过时内容负责。
4、侵权联系： 我尊重他人的知识产权和版权，如果您认为本项目的内容侵犯了您的权益，请通过项目中提供的联系方式与我取得联系。一旦确认侵权行为，我将会立即采取措施删除相关内容或做出调整。
最后，希望您在阅读本项目时能够理解并遵守以上免责声明。感谢您的支持和理解！
项目简介
搭建成果展示
脚本介绍（使用前阅读）
系统相关教程
基于Debian搭建HomeNAS图文教程 （本项目核心教程）
基于Ubuntu搭建HomeNAS图文教程 （本项目核心教程）
Debian系统最小化安装教程
Debian系统通过Cockpit面板直通硬盘安装黑群晖
内网穿透服务Tailscale安装使用教程
Nginx反代限制国外IP访问教程
Docker相关教程
HomePage导航页部署教程
部署Docker版谷歌浏览器教程
B站视频
基于Linux搭建HomeNAS最终效果展示(Debian/Ubuntu)
基于Debian搭建HomeNAS系列教程之系统安装篇
只需8分钟，快速将Debian系统配置成准NAS系统
一首歌的时间，在Debian系统直通硬盘安装黑群晖
以可视化面板展示NAS服务外网访问来源_Nginx日志监控
---
## 交流Q群
```shell
339169752
```
## 星标历史
## 支持与赞赏
如果觉得本项目对您有所帮助，欢迎通过赞赏来支持我的工作！
