Tyk-dashboard打不开主因是MongoDB地址配置错误：localhost在CentOS/RHEL中解析为::1（IPv6），而MongoDB默认仅监听127.0.0.1（IPv4），导致连接拒绝；须将所有配置中的localhost统一改为127.0.0.1，并确认mongod.conf中bindIp包含127.0.0.1、ss -tlnp显示127.0.0.1:27017监听正常。
Tyk 在 Linux 上不能直接 apt/yum install 就完事——它依赖 MongoDB、Redis 和明确的配置顺序，跳过任一环，tyk-dashboard 就会卡在 502 或连不上 mongodb://localhost。
为什么 tyk-dashboard 启动后打不开？常见是 MongoDB 地址写错了
很多教程写 mongo=mongodb://localhost/tyk_analytics，但在 CentOS/RHEL 系统里，localhost 会被解析成 IPv6 的 ::1，而默认 MongoDB 只监听 127.0.0.1。结果就是：命令行 mongo 能连，但 tyk-dashboard 连不上，日志里反复报 connection refused。
- 必须把所有配置里的
localhost换成127.0.0.1，包括tyk_analytics.conf、tyk.conf和setup.sh参数中的--mongo - 检查 MongoDB 是否真在监听：运行
ss -tlnp | grep :27017，确认输出里有127.0.0.1:27017，不是*:27017或:::27017 - 如果用的是 systemd 启动 MongoDB，确保
/etc/mongod.conf中bindIp包含127.0.0.1，不要只写localhost
用 setup.sh 配置时，这些参数不能省略或填错
setup.sh 是 Tyk 官方提供的初始化脚本，但它不校验参数合法性。填错一个，服务起来但功能残缺（比如 API 不认证、Dashboard 无法创建组织）。
-
--redishost=127.0.0.1：必须是 IP，不能是域名或localhost -
--redisport=6379：确认 Redis 确实跑在这个端口（redis-cli ping应返回PONG） -
--mongo=mongodb://127.0.0.1/tyk_analytics：数据库名必须是tyk_analytics，这是 Dashboard 写死的，默认不支持改 -
--tyk_api_hostname=http://localhost：这个值要和你浏览器访问 Dashboard 的地址一致；如果用 IP 访问http://192.168.1.10:3000，这里就得填http://192.168.1.10
启动顺序和端口冲突必须人工盯住
Tyk 组件之间有强依赖：MongoDB → Redis → tyk-gateway → tyk-dashboard。任意一个没就绪，下一个就会失败，但错误日志往往藏在后台服务里，不主动查就以为“启动成功”了。
- 先手动启动 MongoDB：
sudo systemctl start mongod，再执行mongo --eval "db.runCommand({ping:1})"确认响应 - Redis 必须提前运行：
sudo systemctl start redis-server（Ubuntu）或redis（CentOS） -
tyk-gateway默认监听:8080，tyk-dashboard默认监听:3000，确保这两个端口没被占用（sudo ss -tulpn | grep -E ':(8080|3000)'） - 启动
tyk-dashboard后，立刻看日志：sudo journalctl -u tyk-dashboard -f，等出现Dashboard started on port 3000才算真正就绪
配置文件里最容易被忽略的两个字段
tyk.conf 和 tyk_analytics.conf 看似简单，但两个字段不设对，API 请求会静默失败或 404。
-
"secret"：这是 Dashboard 调用 Gateway API 的密钥，必须和tyk_analytics.conf中的admin_secret一致，否则 Dashboard 点“Test API”按钮没反应 -
"listen_port"：Gateway 监听端口，别设成80或443（普通用户无权限），也别和 Nginx/Apache 冲突；建议用8080或8181，并在防火墙放行（sudo firewall-cmd --add-port=8080/tcp --permanent）
实际部署中，最耗时间的不是安装，而是确认每个组件监听的 IP 和端口是否真的可达、配置值是否在所有文件里保持一致。尤其是 127.0.0.1 和 localhost 的混用，以及 MongoDB bindIp 设置，几乎每个新环境都会踩一次。
