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 版(“许可证”)授权;除非遵守许可证,否则您不得使用此文件。您可在以下位置获取许可证副本:
<[***]>
除非适用***要求或书面同意,否则根据许可证分发的软件按“原样”分发,不附带任何明示或暗示的担保或条件。有关许可证下权限和限制的具体语言,请参阅许可证。
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务