



# 一、homepage介绍



## 1.1 Homepage简介
>`Homepage `是一个高度可定制的个人主页（或称起始页、应用仪表盘），专为自托管环境设计，支持 Docker 集成与多种服务 API 对接，兼具美观的现代界面与强大功能，帮助用户打造高效、安全、个性化的每日工作与生活入口。

## 1.2 Homepage主要特点

- **快速加载**：网站在构建时静态生成，实现近乎瞬时的页面加载速度。  
- **安全可靠**：所有后端服务的 API 请求均通过反向代理转发，有效隐藏敏感密钥，防止泄露。  
- **多架构支持**：提供 AMD64 和 ARM64 架构的 Docker 镜像，适配 x86 和树莓派等设备。  
- **全面国际化**：支持超过 40 种语言，满足全球用户本地化需求。  
- **书签管理**：可添加自定义服务链接和网页书签，集中管理常用网站与应用。  
- **Docker 集成**：实时显示容器状态与资源使用情况，支持通过容器标签自动发现服务。  
- **服务集成丰富**：内置 100+ 服务集成，涵盖 Sonarr、Radarr、Plex、Portainer 等主流自建服务。  
- **功能型小部件**：提供天气、时钟、日期、快速搜索等实用小工具，提升日常使用效率。  
- **现代设计风格**：界面简洁优雅，响应式布局，适配桌面与移动设备。  
- **高度可定制**：支持主题、布局、网格大小、深色模式等多样化个性化设置。













# 二、本次实践规划
## 2.1 本地环境规划
>本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。


|hostname| IP地址  | 操作系统版本   |Docker版本   |部署项目
|--|--| --|  --|--|
|jeven01 |192.168.3.88  | Ubuntu 24.04.2 LTS| 28.3.3    | homepage


## 2.2 本次实践介绍
>1.本次实践部署环境为个人测试环境，生产环境请谨慎；
>2.在Docker环境下部署homepage个人导航页工具。





# 三、本地环境检查

## 3.1 检查Docker服务状态
>检查Docker服务是否正常运行，确保Docker正常运行。



```bash
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Mon 2025-08-04 10:10:52 UTC; 30min ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 860 (dockerd)
      Tasks: 10
     Memory: 97.2M (peak: 98.4M)
        CPU: 606ms
     CGroup: /system.slice/docker.service
```



## 3.2  检查Docker版本
>检查Docker版本

```bash
root@jeven:~# docker -v
Docker version 28.3.3, build 980b856
```


## 3.3 检查docker compose 版本
>检查Docker compose版本，确保2.0以上版本。


```bash
root@jeven:~# docker -v
Docker version 28.3.3, build 980b856

```


# 四、拉取homepage镜像
>下载homepage容器镜像，如下所示

```bash
docker pull ghcr.io/gethomepage/homepage:latest
```


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/4f77c8a93c81828c88014d0a22ccc264.png)




























# 五、部署homepage服务


## 5.1 创建部署目录
- 创建部署目录

```bash
mkdir -p /data/homepage/config   &&  cd /data/homepage/
```


## 5.2 编辑部署文件

>使用docker-cli方式部署，可参考以下命令：

```bash
docker run --name homepage \
  -e HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev \
  -e PUID=1000 \
  -e PGID=1000 \
  -p 3000:3000 \
  -v /data/homepage/config:/app/config \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  --restart unless-stopped \
  ghcr.io/gethomepage/homepage:latest
```


>在部署目录下，创建docker-compose.yaml文件，内容如下所示：


```bash
vim docker-compose.yaml
```

```yaml
services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    environment:
      HOMEPAGE_ALLOWED_HOSTS: 192.168.3.88:3000   # required, may need port. See gethomepage.dev/installation/#homepage_allowed_hosts
      PUID: 1000 # optional, your user id
      PGID: 1000 # optional, your group id
    ports:
      - 3000:3000
    volumes:
      - /data/homepage/config:/app/config # Make sure your local config directory exists
      - /var/run/docker.sock:/var/run/docker.sock:ro # optional, for docker integrations
    restart: unless-stopped



```
















## 5.3 创建homepage容器
>执行以下命令，创建homepage容器。


```bash
docker compose up -d
```






![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/f5d10fd7afff14c7841c9d413355df23.png)
















## 5.4 查看homepage容器状态
>检查homepage容器运行状态，确保homepage容器正常启动。

```bash
root@jeven:/data/homepage# docker compose ps
NAME       IMAGE                                 COMMAND                   SERVICE    CREATED          STATUS                    PORTS
homepage   ghcr.io/gethomepage/homepage:latest   "docker-entrypoint.s…"   homepage   33 seconds ago   Up 33 seconds (healthy)   0.0.0.0:3000->3000/tcp, [::]:3000->3000/tcp
```





## 5.5 检查容器运行日志

>检查容器运行日志，确保homepage服务正常运行。

```bash
docker compose logs
```


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/385134f841c6d8d25e6e6f6b0065b54e.png)





























# 六、访问homepage服务

## 6.1 访问homepage首页




>浏览器地址： `http://<个人的服务器IP>:3000`，访问homepager的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/078480f1ce1f08b251cc83e5fb4864cd.png)



## 6.2 添加书签


>在宿主机的/data/homepage/config目录下，修改`bookmarks.yaml`文件，可添加收藏网址。

```bash
vim bookmarks.yaml
```

```bash
root@jeven:/data/homepage/config# cat bookmarks.yaml
---
# For configuration options and examples, please see:
# https://gethomepage.dev/configs/bookmarks

- Developer:
    - Github:
        - abbr: GH
          href: https://github.com/

- Social:
    - Reddit:
        - abbr: RE
          href: https://reddit.com/

- Entertainment:
    - YouTube:
        - abbr: YT
          href: https://youtube.com/
- Search:
    - 必应:
        - abbr: 搜索
          href: https://cn.bing.com/
```



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/2c1ff186ccc34d0e4bc44633374e97d4.png)





>刷新homepage网页后，可以看到书签已经成功添加。




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/bd48d50e3d7130aa853f089d96fa6c93.png)


# 七、总结


>通过本次实践，我们成功使用Docker部署了Homepage个人导航页工具，打造了一个美观且高效的浏览器起始页面。Homepage凭借其静态化加载、丰富的服务集成和高度可定制的界面，显著提升了日常访问常用服务的效率。通过Docker部署，实现了快速安装与便捷维护，同时利用`HOMEPAGE_ALLOWED_HOSTS`等配置保障了访问安全。Homepage不仅适合作为个人主页，也能轻松扩展为家庭或团队的统一服务入口，是自托管生态中不可或缺的实用工具。


Homepage 是一个高度可定制的个人主页（或称起始页、应用仪表盘），专为自托管环境设计，支持 Docker 集成与多种服务 API 对接，兼具美观的现代界面与强大功能，帮助用户打造高效、安全、个性化的每日工作与生活入口。

轻量化导航方案：Docker+Homepage构建高效个人入口

轻量化导航方案：Docker+Homepage 构建高效个人入口

开发工具

运维

后端

Homepage是一款功能强大的个人导航页工具，支持Docker部署，提供快速加载、安全API转发、多架构支持和40+语言国际化。内置100+服务集成和实用小部件，界面简洁优雅，支持主题定制和响应式布局，是提升工作效率的理想选择。

云服务器

服务器

防火墙

容器

Docker

让每一个 Agent，都跑在云上

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

轻量化导航方案：Docker+Homepage构建高效个人入口-腾讯云开发者社区-腾讯云

轻量化导航方案：Docker+Homepage构建高效个人入口

轻量化导航方案：Docker+Homepage构建高效个人入口

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐