Homarr 是一个自托管的主页,用于整合和管理常用的服务和网页链接,使它们可以从一个简洁的界面访问。以下是如何使用 Docker CLI 和 Docker Compose 来部署 Homarr 的详细步骤。
使用 Docker CLI 部署 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 部署 Homarr
-
创建 Docker Compose 文件
在一个空文件中,创建名为
docker-compose.yml
的文件,并填入以下内容:yamlversion: '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
参数使服务在后台运行。