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 参数使服务在后台运行。