LIFF CLI v0.4版
2025 年 6 月 11 日，LINE 官方宣布在 LIFF CLI v0.4 版本中正式支持 ngrok（新版）作为一种稳定、便捷的本地开发公开访问解决方案。这项更新极大提升了开发者在使用 LIFF 平台进行调试、测试及演示时的灵活性和效率。此前，LIFF CLI 仅支持 ngrok v1，而随着 ngrok v1 的生命周期即将终结，更新至最新版本的 ngrok 支持对于所有开发者来说都是一次意义重大的提升。
背景概述
什么是 LIFF？
LIFF（LINE Front-end Framework）是由 LINE软件提供的 Web 应用嵌入框架，允许开发者将网页应用嵌入到 LINE聊天窗口、主页或其他容器中，提供丰富的交互体验。通过 LIFF，开发者可以访问用户资料、发送消息、获取位置等功能，是构建 LINE 生态下小程序和 Web 服务的重要工具。
什么是 ngrok？
ngrok 是一款轻量级的反向代理工具，能够将本地开发服务器暴露到公网，生成可访问的临时 HTTPS 域名，非常适用于演示、Webhook 调试、移动端开发等场景。它以其易用性和跨平台特性，在开发者中具有广泛的使用基础。
LIFF CLI v0.4版 对 ngrok 的支持演进
在早期版本中，LIFF CLI 仅支持 ngrok v1。尽管 v1 在当时满足了基本需求，但由于官方已不再维护该版本，存在稳定性和兼容性风险。此外，ngrok v1 在集成上依赖如 node-pty 的模块，增加了开发和部署复杂度。
为解决这一问题，LIFF CLI v0.4 开始正式支持最新版 ngrok，无需单独安装 ngrok v1 和 node-pty，使部署过程更轻便、兼容性更好。
升级说明与修复事项
值得注意的是，LIFF CLI v0.4.0 存在一个 bug，导致无法正确执行 serve 命令。因此强烈建议使用 v0.4.1 或更高版本，该版本已修复该问题，确保稳定运行。
# 检查当前版本
$ liff-cli --version
# 更新至最新版本
$ npm install -g @line/liff-cli如何使用 ngrok 与 LIFF CLI 进行联动
在 v0.4.1 及以上版本中，使用 liff-cli serve 命令可以通过 ngrok 启动一个代理服务器，将本地服务地址公开到互联网。
步骤一：配置 ngrok Authtoken
在 ngrok 官网注册账号后，可以获取 authtoken。将其设置为环境变量 NGROK_AUTHTOKEN。
export NGROK_AUTHTOKEN=你的-token步骤二：执行 serve 命令
$ NGROK_AUTHTOKEN=你的-token liff-cli serve \
--liff-id 1234567890-AbcdEfgh \
--url http://localhost:3000/ \
--proxy-type ngrok执行结果将返回类似以下信息：
Successfully updated endpoint url for LIFF ID: 1234567890-AbcdEfgh.
→ LIFF URL: https://liff.line.me/1234567890-AbcdEfgh
→ Proxy server: https://1234abcd.ngrok-free.app/此时，你可以通过返回的 LIFF URL 在移动设备上访问运行于本地的 Web 应用，实现在不部署到生产环境的情况下进行调试与体验。
使用场景与优势分析
1. 移动设备调试
无需配置内网穿透工具或部署服务器，即可在手机等终端中直接测试 LIFF 页面效果。
2. 快速共享与演示
在团队协作中，开发者可通过临时 ngrok URL 快速分享本地服务，便于跨团队评审和需求确认。
3. Webhook 与实时交互测试
对于需要回调地址的接口测试（如支付、扫码、认证流程），使用 ngrok 可即时接收回调数据，加快开发迭代。
使用注意事项
- 不要用于生产环境：serve 命令会自动更新 LIFF 应用的端点 URL，避免在已上线项目中使用，以免影响实际业务。
- ngrok URL 是临时的：重启命令后 ngrok 域名将发生变化，若需长期使用应考虑 ngrok 的专业版服务。
- 需网络稳定：ngrok 通信依赖外部网络，若网络不稳定可能造成延迟或连接中断。
优化本地开发与调试的效率
此次 LIFF CLI 对 ngrok 的原生支持，显著优化了本地开发与调试的效率。开发者不再需要依赖老旧的 v1 版本或额外的服务依赖，通过一个简单的命令即可实现公网访问，大大降低了开发门槛。未来，随着 LIFF 平台生态的不断壮大，CLI 工具也将持续迭代，为开发者提供更加稳定、灵活的支持环境。
