kwangyeonc/homepage-config-manager

📊 Homepage Config Manager

简介

Homepage Config Manager 是一个专为 https://github.com/gethomepage/homepage 设计的现代化配置管理工具。它提供了直观的 Web 界面，让您可以轻松管理 Homepage 的所有配置，无需手动编辑 YAML 文件。

🌟 为什么选择 Homepage Config Manager？

• 🎨 直观易用 - 现代化的 Web 界面，告别复杂的 YAML 编辑
• ⚡ 实时同步 - 配置变更立即生效，无需重启服务
• 🔒 安全可靠 - 支持密码保护，配置自动备份
• 📱 响应式设计 - 完美适配桌面端和移动端
• 🐳 容器化部署 - 一键部署，开箱即用

🎯 核心功能

📊 配置管理

• 仪表板 - 配置概览、统计信息、快速操作
• 服务管理 - 添加、编辑、删除服务和分组，支持拖拽排序
• 小部件配置 - 天气、搜索、资源监控等20+种小部件
• 书签管理 - 智能书签分组，支持自定义图标
• 基础设置 - 主题、布局、标题等全局配置

🎨 个性化定制

• 主题系统 - 浅色/深色/自动主题切换
• 自定义样式 - CSS/JS 代码注入
• 图标支持 - 内置图标库 + 自定义图标
• 布局配置 - 灵活的页面布局选项

💾 数据管理

• 自动备份 - 配置变更自动备份
• 导入导出 - 支持配置文件导入导出
• 历史恢复 - 配置历史版本管理
• 实时同步 - 配置变更立即生效

🔒 安全特性

• 密码保护 - 可选的访问密码保护
• 权限控制 - 细粒度的操作权限
• 安全备份 - 加密配置备份

🚀 快速开始

📋 前置要求

• Docker 和 Docker Compose
• 已运行的 https://github.com/gethomepage/homepage 实例

🐳 Docker Compose 部署（推荐）

1. 创建项目目录：

bash
mkdir homepage-stack && cd homepage-stack

2. 创建 docker-compose.yml：

yaml
networks:
  homepage-network:
    driver: bridge

services:
  homepage-config-manager:
    image: kwangyeonc/homepage-config-manager:latest
    container_name: homepage-config-manager
    user: "0:0"
    ports:
      - "3001:3001" #设置 配置页端口
    environment:
      - NODE_ENV=production
      - ACCESS_PASSWORD=321321 # 设置登录密码,防恶意修改 保护机制,如果不需要可以注释掉此行.
      - CONFIG_PATH=/app/config
      - PORT=3001
    volumes:
      - ./config:/app/config:rw
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - homepage-network
    depends_on:
      - homepage
    restart: unless-stopped

#以下如果已安装 可忽略-----------------------------------------------------------------
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    environment:
      HOMEPAGE_ALLOWED_HOSTS: www.xxx.com # 这里填写 用来访问homepage导航页的地址,如果不需要保护 填写 '*'
      PUID: 0 # optional, your user id
      PGID: 0 # optional, your group id
    ports:
      - "3010:3000"  #设置homepage导航页端口
    volumes:
      - ./config:/app/config:rw
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - homepage-network
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  glances:
    image: nicolargo/glances:latest
    container_name: glances
    restart: unless-stopped
    ports:
      - "61208:61208"   # Web UI 端口
      - "61209:61209"   # RESTful API 端口
    volumes:
      - /:/rootfs:ro    # 挂载主机根目录(只读)
      - /var/run:/var/run:ro
      - /sys:/sys:ro
      - /etc/machine-id:/etc/machine-id:ro
      - /etc/localtime:/etc/localtime:ro
    environment:
      - GLANCES_OPT=-w  # 启用 Web 服务器模式
    deploy:
      resources:
        limits:
          memory: 128M

3. 启动服务：

bash
docker-compose up -d

4. 访问应用：
   • Homepage: http://localhost:3000
   • 配置管理器: http://localhost:3001

🔧 独立部署

如果您已有 Homepage 实例，可以单独部署配置管理器：

bash
docker run -d \
  --name homepage-config-manager \
  -p 3001:3001 \
  -v /path/to/homepage/config:/app/config:rw \
  -e ACCESS_PASSWORD=your_password \
  kwangyeonc/homepage-config-manager:latest

📦 可用镜像标签

• kwangyeonc/homepage-config-manager:latest - 最新稳定版
• kwangyeonc/homepage-config-manager:1.13.3 - 指定版本

⚙️ 配置说明

🌍 环境变量

📁 卷挂载

🔒 安全配置

yaml
environment:
  - ACCESS_PASSWORD=your_secure_password  # 设置访问密码
  - NODE_ENV=production                   # 生产环境

📱 使用指南

🎯 首次使用

1. 访问管理界面 - 打开 http://localhost:3001
2. 输入密码 - 如果设置了 ACCESS_PASSWORD
3. 选择配置模板 - 快速开始或从空白配置开始
4. 开始配置 - 使用直观的界面管理您的 Homepage 导航页面

🔧 功能使用

服务管理

• 点击 "服务" 标签页
• 添加新的服务分组
• 为每个服务配置名称、URL、图标等

小部件配置

• 选择 "小部件" 标签页
• 从20+种小部件中选择
• 配置小部件参数
• 实时预览效果

备份管理

• 自动备份：每次配置变更自动创建备份
• 手动备份：在 "备份" 页面创建备份点
• 恢复配置：从历史备份中恢复

🛠️ 技术栈

📁 项目结构

homepage-config-manager/
├── 📁 client/                    # 前端应用
│   ├── 📁 src/
│   │   ├── 📁 api/              # API 接口
│   │   ├── 📁 components/       # React 组件
│   │   ├── 📁 pages/           # 页面组件
│   │   ├── 📁 contexts/        # React Context
│   │   └── 📁 utils/           # 工具函数
│   ├── 📄 package.json
│   └── 📄 vite.config.js
├── 📁 server/                   # 后端服务
│   └── 📄 index.js             # 主服务文件
├── 📁 config/                  # 配置文件目录
├── 📄 Dockerfile              # Docker 构建文件
├── 📄 docker-compose.yml      # Docker Compose 配置
├── 📄 package.json            # 项目依赖
└── 📄 README.md               # 项目文档

🚀 最新版本 1.25.05 (2025-10-13)

🔧 修复几处小问题,提升稳定性

🚀 修复几处小问题,提升稳定性