bitnami/gotrueGoTrue 是一个用 Golang 编写的 API,可处理 Jamstack 项目的用户注册和认证。基于 OAuth2 和 JWT,具备用户注册、认证和自定义用户数据等功能。
GoTrue 概述 商标声明:本软件列表由 Bitnami 打包。所提及的 respective 商标归各自公司所有,使用这些商标并不意味着任何关联或背书。
consoledocker run -it --name gotrue bitnami/gotrue
自 2025 年 8 月 28 日起,Bitnami 将升级其公共目录,在新的 Bitnami 安全镜像计划 下提供精选的加固、安全聚焦镜像集。作为此过渡的一部分:
这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践,提高所有 Bitnami 用户的安全态势。更多详情,请访问 Bitnami 安全镜像公告。
仅有部分 BSI 应用可免费获取。希望访问完整应用目录并获得企业支持?立即尝试 Bitnami 安全镜像商业版。
Dockerfile 链接了解更多关于 Bitnami 标签策略以及滚动标签和不可变标签的区别,请参阅 我们的文档页面。
您可以通过查看分支文件夹中的 tags-info.yaml 文件(即 bitnami/APP/VERSION/OPERATING-SYSTEM/tags-info.yaml),了解不同标签之间的对应关系。
订阅项目更新,请关注 bitnami/containers GitHub 仓库。
获取 Bitnami GoTrue Docker 镜像的推荐方式是从 Docker Hub 仓库 拉取预构建镜像。
consoledocker pull bitnami/gotrue:latest
如需使用特定版本,可拉取带版本的标签。您可在 Docker Hub 仓库中查看 可用版本列表。
consoledocker pull bitnami/gotrue:[标签]
如有需要,您也可通过克隆仓库、切换到包含 Dockerfile 的目录并执行 docker build 命令自行构建镜像。请记得将以下示例命令中的 APP、VERSION 和 OPERATING-SYSTEM 路径占位符替换为正确值。
consolegit clone [***] cd bitnami/APP/VERSION/OPERATING-SYSTEM docker build -t bitnami/APP:latest .
Bitnami 会及时提供 GoTrue 的更新版本,包括安全补丁。建议按照以下步骤升级容器。
consoledocker pull bitnami/gotrue:latest
consoledocker rm -v gotrue
从新镜像重新创建容器。
consoledocker run --name gotrue bitnami/gotrue:latest
| 名称 | 描述 | 默认值 |
|---|---|---|
DB_HOST | 数据库主机 | localhost |
DB_PORT | 数据库端口 | 5432 |
DB_NAME | 数据库名称 | postgres |
DB_USER | 数据库用户名 | postgres |
DB_PASSWORD | 数据库密码 | nil |
DB_SSL | 是否启用数据库 SSL 连接 | disable |
GOTRUE_DB_DATABASE_URL | 数据库 URL | postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}?search_path=auth&sslmode=${DB_SSL} |
GOTRUE_URI_ALLOW_LIST | URI 允许列表 | * |
GOTRUE_OPERATOR_TOKEN | 操作员令牌 | nil |
GOTRUE_JWT_SECRET | JWT 密钥 | nil |
GOTRUE_SITE_URL | 网站 URL | http://localhost:80 |
GOTRUE_API_PORT | API 端口 | 9999 |
GOTRUE_API_HOST | API 主机 | 0.0.0.0 |
API_EXTERNAL_URL | GoTrue 可访问的外部 URL | http://localhost:9999 |
GOTRUE_DISABLE_SIGNUP | 是否禁用注册 | false |
GOTRUE_DB_DRIVER | 数据库驱动 | postgres |
GOTRUE_DB_MIGRATIONS_PATH | 数据库迁移路径 | ${GOTRUE_BASE_DIR} |
GOTRUE_JWT_DEFAULT_GROUP_NAME | JWT 默认组名称 | authenticated |
GOTRUE_JWT_ADMIN_ROLES | JWT 管理员角色 | service_role |
GOTRUE_JWT_AUD | JWT 受众 | authenticated |
GOTRUE_JWT_EXP | JWT 过期时间(秒) | 3600 |
GOTRUE_EXTERNAL_EMAIL_ENABLED | 是否启用外部邮件 | true |
GOTRUE_MAILER_AUTOCONFIRM | 邮件自动确认 | true |
GOTRUE_SMTP_ADMIN_EMAIL | SMTP 管理员*** | *** |
GOTRUE_SMTP_HOST | SMTP 主机 | smtp.example.com |
GOTRUE_SMTP_PORT | SMTP 端口 | 587 |
GOTRUE_SMTP_SENDER_NAME | SMTP 发件人名称 | *** |
GOTRUE_EXTERNAL_PHONE_ENABLED | 是否启用外部电话 | false |
GOTRUE_SMS_AUTOCONFIRM | 短信自动确认 | false |
GOTRUE_MAILER_URLPATHS_INVITE | 邀请链接路径 | http://localhost:80/auth/v1/verify |
GOTRUE_MAILER_URLPATHS_CONFIRMATION | 确认链接路径 | http://localhost:80/auth/v1/verify |
GOTRUE_MAILER_URLPATHS_RECOVERY | 恢复链接路径 | http://localhost:80/auth/v1/verify |
GOTRUE_MAILER_URLPATHS_EMAIL_CHANGE | ***变更链接路径 | http://localhost:80/auth/v1/verify |
| 名称 | 描述 | 值 |
|---|---|---|
GOTRUE_BASE_DIR | GoTrue 安装目录 | ${BITNAMI_ROOT_DIR}/gotrue |
GOTRUE_LOGS_DIR | GoTrue 日志存储目录 | ${GOTRUE_BASE_DIR}/logs |
GOTRUE_LOG_FILE | GoTrue 日志文件路径 | ${GOTRUE_LOGS_DIR}/gotrue.log |
GOTRUE_BIN_DIR | GoTrue 二进制可执行文件目录 | ${GOTRUE_BASE_DIR}/bin |
GOTRUE_DAEMON_USER | GoTrue 系统用户 | supabase |
GOTRUE_DAEMON_GROUP | GoTrue 系统用户组 | supabase |
要在此容器内运行命令,可使用 docker run,例如执行 gotrue --help 可参考以下示例:
consoledocker run --rm --name gotrue bitnami/gotrue:latest --help
有关如何使用 GoTrue 的更多信息,请查看 官方 GoTrue 文档。
Bitnami 安全镜像 目录中的 Bitnami GoTrue Docker 镜像包含额外功能和设置,可配置容器的 FIPS 功能。可配置以下环境变量:
OPENSSL_FIPS:OpenSSL 是否运行在 FIPS 模式。yes(默认)、no。docker-compose.yaml 文件已移除,该文件仅用于内部测试。我们欢迎您为此 Docker 镜像贡献代码。您可以通过创建 issue 请求新功能,或提交 pull request 贡献代码。
如果您在运行此容器时遇到问题,可提交 issue。为了获得更好的支持,请务必填写 issue 模板。
版权所有 © 2025 Broadcom。“Broadcom”一词指 Broadcom Inc. 及其子公司。
根据 Apache 许可证 2.0 版(“许可证”)授权;除非遵守许可证,否则您不得使用此文件。您可在以下位置获取许可证副本:
<[***]>
除非适用***要求或书面同意,否则根据许可证分发的软件按“原样”分发,不附带任何明示或暗示的担保或条件。有关许可证下权限和限制的具体语言,请参阅许可证。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像服务
在 Docker Desktop 配置镜像
Docker Compose 项目配置
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
在宝塔面板一键配置镜像
Synology 群晖 NAS 配置
飞牛 fnOS 系统配置镜像
极空间 NAS 系统配置服务
爱快 iKuai 路由系统配置
绿联 NAS 系统配置镜像
QNAP 威联通 NAS 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
免费版仅支持 Docker Hub 访问,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等;免费版仅支持 docker.io。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
来自真实用户的反馈,见证轩辕镜像的优质服务