7.8 API Key安全实践：后端代理接入
适用版本：ElaneMap H5 API 3.5
前置阅读：7.1-快速入门
适用读者：所有开发接入人员（上线前必读）
一、风险说明：为什么不能把密钥明文写在前端
1.
2.
3.
4.
二、方案一（必须做）：密钥与域名绑定
1.
map.yourcompany.com），可同时绑定测试域名；2.
localhost，生产密钥绑定正式域名；3.
这是最基础、成本最低且最有效的一道防线。即使后续方案都不做，这一条也必须落实。
三、方案二（建议做）：密钥不进代码仓库
3.1 环境变量管理
.env、.env.production 等环境文件，并将 .env.local 加入 .gitignore；3.2 后端动态下发
注意：此方案只解决"密钥不进代码仓库"的问题。密钥下发到浏览器后仍可被该用户本人看到，因此必须与方案一（域名绑定）配合使用。
四、方案三（进阶做）：后端代理数据接口
4.1 架构示意
浏览器 ──(不含密钥)──> 自家后端 /proxy/xxx ──(带密钥)──> 船讯网数据接口
<────── 返回数据 ────── 自家后端 <────── 返回数据 ──────4.2 Node.js（Express）代理示例
4.3 Nginx 反向代理示例（无代码方案）
说明：纯 Nginx 在"按条件追加 query 参数"上能力有限，复杂注入建议用 Nginx+Lua（OpenResty）或上面的 Node/Java 应用层代理实现。
4.4 哪些适合代理，哪些不适合
| 内容 | 是否适合后端代理 | 说明 |
|---|---|---|
| 船位/轨迹/气象等 JSON 数据接口 | 适合 | 请求量可控，可加缓存，收益最大 |
API 主 JS 文件（?k=） | 不适合 | 属于静态库加载，且地图初始化的 ak 参数在前端不可避免 |
| 海图瓦片（tile.c 等） | 不建议 | 瓦片请求量大，代理会显著增加带宽成本与延迟，建议依靠域名绑定防护 |
五、上线前安全检查清单
六、常见问题 FAQ
ak 参数在前端无法隐藏，怎么办？A：是的，
ak 必须在前端传给 ShipxyAPI.Map，这是该版本 API 的机制。因此防护重心放在"域名绑定"上——密钥离开授权域名即失效，明文可见但不影响安全。A：第一时间联系船讯网更换密钥；同时检查调用量记录确认损失范围；排查泄露途径（代码仓库、前端页面、外包人员），修复后再启用新密钥。
A：数据接口代理增加一跳延迟（通常几十毫秒），对船位刷新（秒级）影响可忽略；配合分钟级缓存还能降低密钥配额消耗。瓦片不要代理。
A：不要通过聊天工具直接发送。使用团队密码管理工具或配置中心下发；每人尽量使用个人开发密钥，便于追溯。