Tyk在Linux上需按Redis→MongoDB→Gateway→Dashboard顺序安装，因Gateway启动即连Redis获取API配置与限流数据，Dashboard则依赖Redis和MongoDB（tyk_analytics库）存储日志与统计，任一组件缺失或配置错误（如MongoDB用localhost而非127.0.0.1）均导致connection refused或白屏。
Linux 上安装 Tyk 不是“装一个包就完事”，它本质是三组件协同：Tyk Gateway（核心代理）、Tyk Dashboard（UI 管理后台）、Redis（状态存储）+ MongoDB（分析数据）。缺一不可，顺序和配置稍错就会 connection refused 或 Dashboard 白屏。
为什么必须先装 Redis 和 MongoDB？
Tyk Gateway 启动时会立即连接 Redis 获取 API 定义、密钥、限流计数；Dashboard 启动时既连 Redis 又连 MongoDB（tyk_analytics 库），用于保存仪表盘操作日志、API 使用统计。不提前装好或地址配错，服务根本起不来。
- Redis 必须运行在默认端口
6379，且允许本地连接（bind 127.0.0.1或注释掉 bind 行） - MongoDB 推荐用
mongodb://127.0.0.1/tyk_analytics，不要用localhost—— 某些系统 DNS 解析会导致 Dashboard 连不上（日志里报failed to connect to server [localhost:27017]） - 确认服务状态：
sudo systemctl is-active redis和sudo systemctl is-active mongod都得返回active
用 setup.sh 脚本配 Gateway 和 Dashboard 最稳
别手动改 tyk.conf 或 tyk_analytics.conf —— 官方 setup.sh 会校验路径、生成密钥、写入正确 host/port，并自动处理 systemd 服务注册。出错率比手写低 80%。
- Gateway 配置命令示例：
sudo /opt/tyk-gateway/install/setup.sh --listenport=8080 --redishost=127.0.0.1 --redisport=6379 - Dashboard 配置命令示例：
sudo /opt/tyk-dashboard/install/setup.sh --listenport=3000 --redishost=127.0.0.1 --redisport=6379 --mongo=mongodb://127.0.0.1/tyk_analytics --tyk_api_hostname=localhost --tyk_node_port=8080 - 关键点：
--tyk_node_port必须和 Gateway 的listen_port一致；--tyk_api_hostname建议填localhost，避免 DNS 解析失败
启动后打不开 http://localhost:3000？先查这三处
Dashboard 白屏或 Connection Refused 是高频问题，90% 出在以下环节：
- 检查
sudo journalctl -u tyk-dashboard -n 50 --no-pager，重点看有没有Failed to connect to MongoDB或Redis connection timeout - 确认
tyk-gateway已启动：sudo systemctl status tyk-gateway，若显示inactive，执行sudo systemctl start tyk-gateway并等 5 秒再试 Dashboard - 防火墙是否拦了
3000端口？运行sudo ufw status（Ubuntu）或sudo firewall-cmd --list-ports（CentOS），没开就加规则：sudo ufw allow 3000
配置完第一件事：改默认 secret 和 node_secret
刚装好的 Tyk 默认 secret 是 352d20ee67be69f69a74d729534500e6，node_secret 是 352d20ee67be69f69a74d729534500e6 —— 这俩硬编码在 /opt/tyk-gateway/tyk.conf 里，不改等于把网关钥匙贴在门口。
- 生成新密钥：
openssl rand -hex 16（两次，分别给secret和node_secret） - 编辑
/opt/tyk-gateway/tyk.conf，替换"secret"和"node_secret"字段值 - 重启：
sudo systemctl restart tyk-gateway；Dashboard 不需要重启，它通过 API 从 Gateway 拉取配置
真正麻烦的不是安装步骤，而是组件间隐式依赖——比如 Gateway 没起来，Dashboard 就永远连不上 MongoDB；MongoDB 地址写成 localhost 在某些发行版里就解析失败。这些细节不踩一遍坑，很难靠文档猜出来。
