初次配置 | Docker 安装 Gogs

第一次运行时配置 Gogs

第一次运行时，Gogs 将自动创建默认数据库并设置所有表。你只需要设置管理员凭据、站点名称和 URL。运行时设置完这些信息，将来就可以使用了。

访问 Docker Hub

前往 Docker Hub，查看所有可用镜像，或从 Gogs docker 镜像开始配置向导。

运行时设置

你可以通过 docker run -p 3000:3000 --name gogs gogs/gogs 运行容器。第一次运行后，Gogs 将自动创建默认数据库并设置所有表。你只需要设置管理员凭据、站点名称和 URL。运行时设置完这些信息，将来就可以使用了。

示例：

docker run -d \
    --name=gogs \
    -p 3000:3000 \
    -v /data/gogs:/data \
    gogs/gogs

你可以使用 -e 参数设置管理员凭据、站点名称和 URL。请注意，管理员的用户名和密码需要至少有 5 个字符。

示例：

docker run -d \
    --name=gogs \
    -p 3000:3000 \
    -v /data/gogs:/data \
    -e "GOGS_CUSTOM_DOMAIN=example.com" \
    -e "GOGS_HTTP_PORT=3000" \
    -e "GOGS_ROOT_URL=https://example.com" \
    -e "GOGS_DB_TYPE=postgres" \
    -e "GOGS_DB_HOST=127.0.0.1:5432" \
    -e "GOGS_DB_USER=gogs" \
    -e "GOGS_DB_PASS=gogs" \
    -e "GOGS_DB_NAME=gogs" \
    -e "GOGS_ADMIN_NAME=admin" \
    -e "GOGS_ADMIN_PASSWORD=password" \
    gogs/gogs

备注：

• 为了安全起见，建议将密码存储在环境变量中，而不是直接在命令中指定。
• 如果要使用非默认数据库，请参阅 Gogs 文档中的更多详细信息。

运行后设置

设置完所有运行时信息后，Gogs 应该可以正常运行了。你可以通过 http://localhost:3000 访问它。

第一次访问 Gogs 时，你需要设置管理员凭据、站点名称和 URL。此后，这些信息将存储在数据库中，你可以在设置中更改它们。

升级 Gogs

你可以使用以下命令升级 Gogs：

docker pull gogs/gogs
docker stop gogs
docker rm gogs
docker run -d \
    --name=gogs \
    -p 3000:3000 \
    -v /data/gogs:/data \
    gogs/gogs

备注：

• 如果要保留 Gogs 数据，请在删除容器之前备份 /data/gogs 目录。
• 如果要使用非默认数据库，请参阅 Gogs 文档中的更多详细信息。

故障排除

如果你在运行 Gogs 时遇到问题，可以查看 Gogs 文档中的故障排除指南。