一、homarr介绍
1.1 homarr简介
homarr可作为网站书签导航页工具，Homarr也是一个时尚、现代的仪表板，可让您的所有应用程序和服务触手可及。使用Homarr，您可以在一个方便的位置访问和控制所有内容。
1.2 homarr特点
🖌️ 通过广泛的拖放网格系统高度可定制
- ✨与您喜爱的自托管应用程序无缝集成
- 📌简单快速的应用程序管理 - 不涉及 YAML
- 🙊先进的机密管理系统，增强安全性
- 📄详细的文档和活跃的社区
- 🔍 立即搜索网络或支持的集成
- 🏴使用内置状态系统监控您的应用程序
- 🦞全面的内置图标选择器，包含 7000 多个图标
- 🐳 使用 Docker、unRAID 和 Synology 轻松部署
- 🚀与任何主要的消费类硬件（x86，树莓派，旧笔记本电脑等）兼容
- 💵免费和开源 - 您的数据保留在您的设备上。没有遥测数据。
1.3 homarr使用场景
Homarr作为一款网站书签导航页工具，它的使用场景广泛且实用，特别适合以下几类用户和情景：
多任务处理者：对于那些需要频繁切换于不同网站、应用或服务之间的用户，如数字游民、自由职业者、项目经理等，Homarr提供了一个集中的平台来快速访问所有工作相关的资源，提高了工作效率。
学生与研究人员：在进行学术研究或在线学习时，学生和研究人员往往需要访问多个数据库、学术期刊和参考网站。Homarr可以帮助他们将所有重要资源整理得井井有条，便于快速查找和引用。
日常网络冲浪者：对于喜欢探索互联网新奇内容的用户，Homarr可以作为一个个性化首页，收藏新闻站点、社交媒体、博客、视频平台等，让每日的网络浏览体验更加流畅和个性化。
团队协作：在团队环境中，Homarr可以作为一个共享的工作台，团队成员可以共同维护一套书签集合，确保所有人都能轻松访问到项目管理工具、共享文档、设计资源等，促进团队协作和信息同步。
个人知识管理：对于注重个人知识体系构建的用户，Homarr是一个优秀的工具来组织和分类学习资源、灵感来源和个人兴趣站点，帮助构建个人的在线图书馆。
跨设备同步：对于在多设备间切换使用的用户，Homarr支持跨平台同步功能，确保无论是在家用电脑、办公室笔记本还是移动设备上，都能无缝访问相同的书签和设置，提升了使用体验的一致性。
二、本地环境介绍
2.1 本地环境规划
本次实践为个人测试环境，操作系统版本为centos7.6。
| hostname | IP地址 | 操作系统版本 | Docker版本 |
|---|---|---|---|
| jeven | 192.168.3.166 | centos 7.6 | 20.10.17 |
2.2 本次实践介绍
1.本次实践部署环境为个人测试环境，生产环境请谨慎使用；
2.在Docker环境下成功部署homarr个人导航页。三、本地环境检查
3.1 检查Docker服务状态
检查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版本
检查Docker版本
[root@jeven ~]# docker version
Client: Docker Engine - Community
Version: 20.10.17
API version: 1.41
Go version: go1.17.11
Git commit: 100c701
Built: Mon Jun 6 23:05:12 2022
OS/Arch: linux/amd64
Context: default
Experimental: true
Server: Docker Engine - Community
Engine:
Version: 20.10.17
API version: 1.41 (minimum version 1.12)
Go version: go1.17.11
Git commit: a89b842
Built: Mon Jun 6 23:03:33 2022
OS/Arch: linux/amd64
Experimental: false
containerd:
Version: 1.6.6
GitCommit: 10c12954828e7c7c9b6e0ea9b0c02b01407d3ae1
runc:
Version: 1.1.2
GitCommit: v1.1.2-0-ga916309
docker-init:
Version: 0.19.0
GitCommit: de40ad0
3.3 检查docker compose 版本
检查Docker compose版本，确保2.0以上版本。
[[root@jeven ~]# docker compose version
Docker Compose version v2.19.1
四、下载homarr镜像
在docker hub下载homarr镜像 ghcr.io/ajnart/homarr:latest
如果镜像拉取缓慢，可使用我仓库的swr.cn-north-4.myhuaweicloud.com/jeven/homarr:latest镜像。
[root@jeven ~]# docker pull ghcr.io/ajnart/homarr:latest
latest: Pulling from ajnart/homarr
31e352740f53: Already exists
11d56374b943: Pull complete
03c6b1d5f51e: Pull complete
d4fe5e85fcdf: Pull complete
0404ea77c3f1: Pull complete
901c3b6f9e06: Pull complete
d75131c3fd40: Pull complete
0b9d27af4cb0: Pull complete
ea9ea30b8736: Pull complete
b981932a56ab: Pull complete
Digest: sha256:441556ea9d52a12fc96811da73e832c3a477e3e4defd880dfe96bd32f1a7b520
Status: Downloaded newer image for ghcr.io/ajnart/homarr:latest
ghcr.io/ajnart/homarr:latest
五、部署homarr导航页
5.1 创建挂载目录
- 创建挂载目录
mkdir -p /data/homarr/configs && mkdir -p /data/homarr/icons
5.2 创建homarr容器
使用docker run快速创建homarr容器
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 检查homarr容器状态
检查homarr容器运行状态
[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 添加网址
进入编辑模式——添加apps,添加网址https://github.com/，添加完毕，可以正常打开自定义网址。
7.3 设置搜索引擎
在设置中，设置搜索网址为https://www.baidu.com/s?ie=UTF-8&wd=
7.4 修改天气
设置主页天气城市位置，选择北京，保存即可。
八、总结
Homarr是一款集时尚设计与高效功能于一体的网站书签及应用程序导航工具，它将你的数字世界整合为一目了然的个性化仪表板，无论是日常浏览、深度工作还是团队协作，都能确保所有重要资源与服务触手可及，极大提升了在线操作的便捷性与效率，让数字化生活与工作井然有序，尽在掌控。
