什么是Homarr？

Homarr是一个现代化的自托管服务导航面板，专为服务器管理员和高级用户设计。它允许您将所有常用的服务、工具和网站链接集中在一个简洁的仪表板上，提供快速访问和状态监控功能。Homarr以其轻量级、高度可定制和用户友好的界面而受到技术爱好者的青睐。

为什么选择Homarr？

开源免费：Homarr是完全开源的，没有任何隐藏费用易于部署：支持Docker容器化部署，几分钟内即可完成安装高度可定制：可以添加各种小部件和服务链接响应式设计：适配各种设备屏幕集成丰富：支持多种服务的状态监控

准备工作

在开始安装Homarr之前，您需要准备：

一台运行Linux的服务器（推荐使用Ubuntu或Debian）Docker和Docker Compose已安装域名（可选，用于通过HTTPS访问）基础命令行操作知识

如果您还没有合适的服务器，可以考虑使用CIUIC云服务器，它提供稳定可靠的云计算服务，非常适合部署各种自托管应用。

安装步骤

1. 安装Docker和Docker Compose

如果您的系统尚未安装Docker，可以运行以下命令：

# 安装Dockercurl -fsSL https://get.docker.com | shsudo systemctl enable --now docker# 安装Docker Composesudo curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

2. 创建Homarr部署目录

mkdir ~/homarr && cd ~/homarr

3. 创建docker-compose.yml文件

使用您喜欢的文本编辑器创建docker-compose.yml文件：

version: '3.8'services:  homarr:    image: ghcr.io/ajnart/homarr:latest    container_name: homarr    restart: unless-stopped    ports:      - "7575:7575"    volumes:      - ./configs:/app/data/configs      - ./icons:/app/public/icons    environment:      - PUID=1000      - PGID=1000      - TZ=Asia/Shanghai

4. 启动Homarr容器

docker-compose up -d

配置Homarr

安装完成后，您可以通过浏览器访问http://您的服务器IP:7575来访问Homarr面板。

首次访问时，您会看到默认的仪表板。要进行个性化配置：

点击右上角的设置图标添加您常用的服务和工具调整布局和主题设置添加小部件（如系统状态、天气预报等）

高级配置

使用Nginx反向代理（可选）

为了通过域名访问并启用HTTPS，您可以设置Nginx反向代理：

安装Nginx和Certbot

sudo apt install nginx certbot python3-certbot-nginx

创建Nginx配置文件/etc/nginx/sites-available/homarr.conf：

server {    listen 80;    server_name yourdomain.com;    location / {        proxy_pass http://localhost:7575;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;    }}

启用配置并获取SSL证书

sudo ln -s /etc/nginx/sites-available/homarr.conf /etc/nginx/sites-enabled/sudo nginx -tsudo systemctl reload nginxsudo certbot --nginx -d yourdomain.com

定期备份配置

Homarr的配置存储在~/homarr/configs目录中，建议定期备份此目录。

常见问题解决

端口冲突：如果7575端口已被占用，可以在docker-compose.yml中修改端口映射权限问题：确保Docker有权限访问配置目录更新Homarr：只需运行docker-compose pull && docker-compose up -d即可更新到最新版本

Homarr是一个功能强大且易于使用的服务导航面板，特别适合管理多台服务器或多个自托管服务的用户。通过本文的指南，您应该已经成功在您的服务器上部署了Homarr。如果您需要可靠的云服务器来运行Homarr或其他应用，可以考虑使用CIUIC云服务，它提供高性能的云计算解决方案。

随着您不断添加更多服务到Homarr中，您会发现它大大提高了工作效率，让服务器管理变得更加轻松愉快。Happy homarr-ing!