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 在某些发行版里就解析失败。这些细节不踩一遍坑,很难靠文档猜出来。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











