# geckos **Repository Path**: iamxcd/geckos ## Basic Information - **Project Name**: geckos - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-30 - **Last Updated**: 2026-05-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🦎 Geckos Web OS > 专为家庭服务器、NAS、小主机设计的轻量级 Web 管理面板 > 让服务器管理像操作本地电脑一样简单 ![主界面](images/主界面.png) --- ## ✨ 为什么选择 Geckos？ ### 🏠 完美适配家庭服务器场景 - **轻量级** - 内存占用低，适合小主机、树莓派、NAS 等设备 - **零配置** - 一键安装，自动初始化，开箱即用 - **All-in-One** - 一个面板管理所有服务，无需安装多个工具 - **随时随地** - 手机、平板、电脑都能访问，远程管理家中服务器 ### 🚀 一站式服务器管理 告别繁琐的命令行操作，通过直观的 Web 界面轻松管理您的家庭服务器： | 功能 | 适用场景 | |------|----------| | 🖥️ **Web 终端** | 无需 SSH，浏览器直接执行命令 | ![终端](images/终端.png) | 📁 **文件管理** | 管理 NAS 文件、媒体资源、下载目录 | | 🔧 **Docker 管理** | 一键部署 Home Assistant、Jellyfin、QBittorrent 等 | | 📊 **系统监控** | 实时查看 CPU、内存、磁盘使用情况 | | ⚡ **进程管理** | 查看运行中的服务，一键结束异常进程 | | 🔌 **插件扩展** | 安装各种家庭服务器专用插件 | ### 🎨 现代化界面 - 📱 **响应式设计** - 手机、平板、电脑完美适配 - 🌙 **深色模式** - 夜间使用不刺眼 - 🌐 **多语言** - 支持中文、英文 --- ## 📥 安装部署 ### 硬件要求 | 配置 | 最低要求 | 推荐配置 | |------|----------|----------| | CPU | x86_64 / ARM64 | 任意现代处理器 | | 内存 | 512 MB | 1 GB+ | | 磁盘 | 100 MB | 1 GB+ | | 系统 | Linux | Ubuntu / Debian / CentOS | > 💡 **适用设备**: 树莓派、N1 小主机、NAS、旧笔记本、云服务器等 ### 快速安装（推荐） ```bash curl -fsSL https://geckos.vistaweb.cn/install.sh | sudo bash ``` 安装完成后，访问 `http://服务器IP:18010` ### 手动安装 ```bash # 1. 创建安装目录 mkdir -p /opt/geckos && cd /opt/geckos # 2. 下载最新版本 wget https://geckos.vistaweb.cn/geckos/0.1.0/geckos.zip # 3. 解压并启动 unzip geckos.zip && ./geckos ``` **默认账号**: `admin` / `123456` ⚠️ 首次登录请立即修改密码！ ![登录界面](images/登录界面.png) --- ## 🏠 家庭服务器使用指南 ### 🖥️ 管理你的家庭服务 #### 场景 1：部署智能家居系统 使用 Docker 管理一键部署 Home Assistant： 1. 进入"Docker"页面 2. 点击"拉取镜像"，搜索 `homeassistant/home-assistant` 3. 创建容器，映射配置文件目录 4. 访问 `http://服务器IP:8123` 完成 Home Assistant 初始化 #### 场景 2：搭建家庭影音中心 部署 Jellyfin 媒体服务器： 1. 在 Docker 页面搜索 `jellyfin/jellyfin` 2. 创建容器，映射媒体文件夹 3. 配置硬件加速（可选） 4. 手机、电视安装 Jellyfin 客户端即可播放 #### 场景 3：管理下载资源 部署 QBittorrent 下载工具： 1. Docker 中搜索 `linuxserver/qbittorrent` 2. 配置下载目录映射到 NAS/硬盘 3. 通过 Web 界面管理 BT/PT 下载 ### 📁 文件管理 - 你的私人网盘 ![文件管理](images/文件管理.png) 像操作本地文件一样管理服务器文件： - 📤 **拖拽上传** - 照片、视频、文档直接拖入浏览器上传 - 📱 **手机访问** - 外出时也能查看家中文件 - 📝 **在线编辑** - 直接修改配置文件、代码 - 📦 **压缩/解压** - 处理下载的压缩包 - 🔗 **分享链接** - 生成临时链接分享文件给朋友 ### 📊 系统监控 - 守护你的小主机 实时监控家庭服务器状态： - **CPU/内存** - 查看哪些服务占用资源 - **磁盘空间** - 避免 NAS 存储满了不知道 - **网络流量** - 监控上传下载速度 - **温度监控** - 防止小主机过热（需配合插件） ### 🔌 插件市场 - 扩展无限可能 从插件市场安装各种家庭服务器工具： | 插件 | 功能 | |------|------| | AdGuard Home | 全屋广告拦截 | | Pi-hole | DNS 去广告 | | Alist | 网盘聚合 | | Aria2 | 离线下载 | | PhotoPrism | 照片管理 | 安装方法： 1. 进入"插件管理" 2. 浏览插件市场 3. 点击安装，自动部署 4. 在左侧菜单使用 --- ## 🚀 系统升级 ### 在线升级（推荐） 1. 登录 Geckos 管理后台 2. 进入"系统设置" → "系统升级" 3. 点击"检查更新" 4. 如有新版本，点击"立即升级" ### 手动升级 ```bash # 1. 备份数据 cp -r /opt/geckos/data /opt/geckos/data.backup # 2. 停止服务 sudo systemctl stop geckos # 3. 下载新版本 cd /opt/geckos wget https://geckos.vistaweb.cn/geckos/0.2.0/geckos.zip unzip -o geckos.zip # 4. 启动服务 sudo systemctl start geckos ``` --- ## 🗑️ 卸载程序 ⚠️ **警告：卸载前请务必备份重要数据，数据丢失不可恢复！** ### 自动卸载（推荐） ```bash curl -fsSL https://geckos.vistaweb.cn/uninstall.sh | sudo bash ``` 卸载脚本会： 1. 停止 Geckos 服务 2. 询问是否备份数据（建议备份） 3. 删除安装文件 ### 手动卸载 ```bash # 1. 停止服务 sudo systemctl stop geckos # 2. 禁用服务 sudo systemctl disable geckos # 3. 备份数据（重要！） cp -r /opt/geckos/data ~/geckos-data-backup cp /opt/geckos/config.yaml ~/geckos-config-backup.yaml # 4. 删除安装目录 sudo rm -rf /opt/geckos # 5. 删除服务文件 sudo rm -f /etc/systemd/system/geckos.service sudo systemctl daemon-reload ``` ---

🎉 开始打造你的智能家居中枢吧！

官方网站 • 立即安装 • 使用指南