一、Homarr介绍

1.1 Homarr简介

Homarr 是一款支持自托管的网站书签导航工具，同时也是一个时尚、现代的仪表盘，旨在让您的所有应用程序和服务一览无余。它提供了便捷的资源访问和控制能力，是个人和团队的理想选择。

1.2 Homarr特点

• 高度可定制：通过直观的拖放网格系统，自由配置页面布局。
• 无缝集成：支持与多种自托管应用程序快速对接。
• 操作简单：无需复杂的配置文件，仅需几步即可完成管理。
• 安全性增强：内置高级机密管理系统。
• 内置搜索与状态监控：支持快速网络搜索和服务状态实时监控。
• 多平台兼容：可运行在主流消费类硬件设备上（树莓派、x86等）。
• 开源与隐私保护：代码完全开源，数据留存在本地，无需担忧隐私泄露。

1.3 Homarr使用场景

• 个人网站书签管理：集中管理个人常用站点，便捷快速访问。
• 团队协作：作为团队共享工具，集中管理项目、资源和任务。
• 家庭服务器管理：用于整合家庭媒体中心、NAS等自托管应用。
• 教育与学习：组织学术研究、在线课程及学习资源。
• 个人工作台：轻松集成所有必要工具，提高工作效率。

二、本地环境介绍

2.1 本地环境规划

本次实践部署在个人测试环境，配置如下：

2.2 本次实践说明

1. 部署环境：测试环境，生产环境请谨慎操作。
2. 目标：在Docker环境下部署 Homarr 个人导航页。

三、本地环境检查

3.1 检查Docker服务状态

确保Docker服务已启动且运行正常：

[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Mon 2023-08-07 23:25:04 CST; 14h ago
     Docs: https://docs.docker.com
 Main PID: 11587 (dockerd)
    Tasks: 10
   Memory: 135.7M

3.2 检查Docker版本

[root@jeven ~]# docker version
Docker version 20.10.17, build 100c701

3.3 检查Docker Compose版本

确保Docker Compose版本在2.0及以上：

[root@jeven ~]# docker compose version
Docker Compose version v2.19.1

四、下载Homarr镜像

从Docker Hub拉取Homarr镜像：

[root@jeven ~]# docker pull ghcr.io/ajnart/homarr:latest

若镜像下载缓慢，可使用国内镜像仓库：

docker pull swr.cn-north-4.myhuaweicloud.com/jeven/homarr:latest

五、部署Homarr导航页

5.1 创建挂载目录

创建挂载目录以存储配置文件和图标：

mkdir -p /data/homarr/configs && mkdir -p /data/homarr/icons

5.2 创建Homarr容器

使用Docker命令快速创建容器：

docker run \
  --name homarr \
  --restart unless-stopped \
  -p 7666:7575 \
  -v /data/homarr/configs:/app/data/configs \
  -v /data/homarr/icons:/app/public/icons \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -d ghcr.io/ajnart/homarr:latest

5.3 检查容器状态

确保容器运行正常：

[root@jeven homarr]# docker ps
CONTAINER ID   IMAGE                          COMMAND                  CREATED          STATUS          PORTS                                       NAMES
f0dfb29fd905   ghcr.io/ajnart/homarr:latest   "docker-entrypoint.s…"   20 seconds ago   Up 19 seconds   0.0.0.0:7666->7575/tcp, :::7666->7575/tcp   homarr

5.4 检查容器日志

查看日志确保服务已启动：

[root@jeven homarr]# docker logs homarr
Listening on port 7575 url: http://f0dfb29fd905:7575

六、访问Homarr首页

访问地址：http://192.168.3.166:7666
将IP地址替换为您服务器的实际IP。

七、Homarr的基本使用

7.1 设置中文语言

在设置中选择语言为中文：

7.2 添加网址

进入编辑模式，添加常用网站如 https://github.com/：

7.3 设置搜索引擎

自定义搜索引擎，例如百度：

https://www.baidu.com/s?ie=UTF-8&wd=

7.4 修改天气信息

将默认城市修改为“北京”：

八、总结

Homarr 是一款强大、时尚的导航工具，帮助用户轻松整合数字资源。它将导航页与应用程序仪表盘相结合，为个人、家庭和团队提供了一个高效便捷的入口。不论是用于工作还是娱乐，Homarr都能助您优化在线体验，提高效率。