Docker部署home-page个人导航页保姆级教程

时间：2026-08-13

一、home-page个人导航页介绍

1.1 home-page简介

home-page简介

home-page是一款一个简洁的NAS导航页面&主页

1.2 home-page使用场景

家庭网络存储：可以将NAS设备连接到家庭网络中，通过home-page来管理和访问存储在NAS上的文件和数据。用户可以使用主页来快速浏览文件夹、上传和下载文件，以及搜索文件。
小型办公室：对于小型办公室或团队，home-page可以用作集中存储和共享文件的平台。用户可以通过主页轻松地浏览存储在NAS上的文件，与团队成员共享文件夹，并设置访问权限。
远程访问：home-page还提供了远程访问的功能，使用户可以在任何地方通过互联网连接到NAS设备并访问文件。这对于需要在不同地点之间共享和管理文件的用户非常方便。
多媒体共享：如果NAS设备主要用来存储和共享照片、视频、音乐这类媒体内容，那么home-page就很适合作为媒体库的入口页和主页来使用。通过这个主页，用户可以更顺手地浏览各类媒体文件，也能直接调用内置播放器播放视频和音乐，整个过程会更直观。
二、本地环境介绍
2.1 本地环境规划
本次实践为个人测试环境，操作系统版本为centos7.6。

hostnameIP地址操作系统版本Docker版本jeven192.168.3.166centos 7.620.10.17

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下成功部署home-page个人导航页。

三、本地环境检查

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 Sat 2023-11-04 21:48:30 CST; 1 day 18h ago
     Docs: https://docs.docker.com
 Main PID: 43919 (dockerd)
    Tasks: 63
   Memory: 171.9M
   CGroup: /system.slice/docker.service

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

四、下载home-page镜像

在docker hub下载kahosan/home-page镜像

[root@jeven ~]# docker pull kahosan/home-page
Using default tag: latest
latest: Pulling from kahosan/home-page
96526aa774ef: Already exists
824de1d006d4: Pull complete
76c34934b331: Pull complete
fdef87f136ff: Pull complete
eea78192431d: Pull complete
3c90c684c8c2: Pull complete
d582057a6e90: Pull complete
59b02d3b77e5: Pull complete
2a799944fdb0: Pull complete
d8096d7c6ba9: Pull complete
891feb70e715: Pull complete
585d7f93433f: Pull complete
Digest: sha256:0ee8a54c69ecf0e6c0f930d4c6c925467e941f801abc300b50d700b5d45fa05d
Status: Downloaded newer image for kahosan/home-page:latest
docker.io/kahosan/home-page:latest

五、部署home-page导航页

5.1 创建挂载目录

mkdir -p /data/home-page/configs && cd /data/home-page

chmod -R 777 /data/home-page/

5.2 修改services.json文件

可以根据需要修改configs/services.json文件。

vim configs/services.json

[
  {
    "name": "百度",
    "path": "https://www.baidu.com",
    "description": "百度搜索",
    "icon": "logo-react"
  },
  {
    "name": "示例卡片",
    "path": "/tmp",
    "description": "这是一个示例",
    "icon": "logo-react"
  },
  {
    "name": "示例卡片2",
    "path": "/tmp",
    "description": "这是另一个示例",
    "icon": "logo-react"
  }
]

5.3 编辑docker-compose.yaml文件

编辑docker-compose.yaml文件

version: '3'
services:
  home-page:
    container_name: home-page
    image: kahosan/home-page
    user: 1000:1000
    environment:
      - TZ=Asia/Shanghai
#      - NEXT_PUBLIC_HOME_TWITTER=https://twitter.com/kaho_suyf
      - NEXT_PUBLIC_HOME_BLOG=http://192.168.3.208:8090/ #个人博客地址
      - NEXT_PUBLIC_HOME_HEADER_TITLE=我的导航   #主标题
      - NEXT_PUBLIC_HOME_TITLE=我的网站    #副标题
    volumes:
      - /data/home-page/configs/services.json:/app/services.json
    ports:
      - 3000:3000

5.4 创建home-page容器

使用docker compose 快速创建home-page容器

docker compose up -d

5.5 检查home-page容器状态

检查home-page容器运行状态

[root@jeven home-page]#  docker ps
CONTAINER ID   IMAGE                                 COMMAND                  CREATED          STATUS          PORTS                              NAMES
4d75dc6f6ec1   kahosan/home-page                     "docker-entrypoint.s…"   46 seconds ago   Up 44 seconds   0.0.0.0:3000->3000/tcp, :::3000->3000/tcp   home-page

5.6 检查home-page容器日志

检查home-page容器运行日志，确保home-page服务正常启动。

[root@jeven home-page]# docker logs home-page
  ▲ Next.js 13.5.3
  - Local:        http://4d75dc6f6ec1:3000
  - Network:      http://172.24.0.2:3000

 ✓ Ready in 118ms