Homarr 是一个自托管的主页,用于整合和管理常用的服务和网页链接,使它们可以从一个简洁的界面访问。以下是如何使用 Docker CLI 和 Docker Compose 来部署 Homarr 的详细步骤。
拉取 Homarr 镜像
首先,需要从 Docker Hub 拉取最新的 Homarr 镜像。
docker pull ghcr.io/ajnart/homarr:latest
运行 Homarr 容器
使用下面的命令来运行 Homarr 容器,同时设定需要的参数:
docker run -d \
--name=homarr \
-p 7878:80 \
-v /path/to/config:/app/config \
--restart=unless-stopped \
ghcr.io/ajnart/homarr:latest
-d
参数表示后台运行容器。--name=homarr
设定容器的名称为 homarr
。-p 7878:80
映射容器内的 80 端口到宿主机的 7878 端口。-v /path/to/config:/app/config
映射宿主机上的配置目录到容器内的 /app/config
,用于持久化配置。--restart=unless-stopped
确保容器在退出时重启,除非它被明确停止。创建 Docker Compose 文件
在一个空文件中,创建名为 docker-compose.yml
的文件,并填入以下内容:
version: '3'
services:
homarr:
image: ghcr.io/ajnart/homarr:latest
container_name: homarr
volumes:
- /path/to/config:/app/config
ports:
- "7878:80"
restart: unless-stopped
version: '3'
指定了 Docker Compose 文件的版本。services:
下面定义了要部署的服务。image:
指定了要使用的 Homarr 镜像。container_name:
定义了容器的名称。volumes:
映射宿主机上的配置目录到容器内,以持久化配置。ports:
映射容器内的端口到宿主机。restart:
设置重启策略。启动服务
使用以下命令启动 Homarr 服务:
docker-compose up -d
-d
参数使服务在后台运行。