本地开发如何配置持久化Stripe Webhook密钥？

最优方案：团队共用同一持久化密钥 #

适合团队统一开发环境，避免重复配置：

1. 创建固定Webhook端点：在Stripe测试仪表板中，新建一个本地开发专用的Webhook端点，设置转发地址为http://host.docker.internal:8000/subscriptions/webhook，生成并记录该端点的签名密钥（格式为whsec_xxx）。
2. 配置共享环境变量：将签名密钥添加到团队共享的.env文件中：

   STRIPE_WEBHOOK_SECRET=whsec_your_fixed_team_secret_key
   

3. 更新docker-compose配置：在Stripe CLI的命令中加入--secret参数指定该密钥，可选添加--events明确监听的事件以减少冗余：

   stripe:
       image: stripe/stripe-cli
       container_name: stripe-service
       env_file:
         - .env
       command: >
         listen --api-key ${STRIPE_SECRET_KEY}
           --forward-to http://host.docker.internal:8000/subscriptions/webhook
           --secret ${STRIPE_WEBHOOK_SECRET}
           --skip-update --skip-verify
           # 可选示例：指定监听事件 --events checkout.session.completed,invoice.paid
       restart: unless-stopped
   

4. 同步服务验证配置：团队所有成员的本地服务器，统一使用该固定签名密钥验证Webhook签名，确保环境一致性。

次优方案：每位开发者配置个人持久化密钥 #

适合团队成员需要独立开发环境的场景：

1. 本地初始化Stripe CLI配置：每个开发者在本地终端执行以下命令，登录个人Stripe测试账号并保存Webhook配置：

   # 登录Stripe账号（会跳转浏览器完成验证）
   stripe login
   # 保存Webhook监听配置，生成个人专属持久化密钥
   stripe listen --save \
     --api-key your_personal_stripe_secret_key \
     --forward-to http://host.docker.internal:8000/subscriptions/webhook \
     --skip-update --skip-verify
   

   配置会自动保存到本地Stripe CLI目录：Mac/Linux为~/.config/stripe/config.toml，Windows为%USERPROFILE%/.config/stripe/config.toml。
2. 挂载本地配置到容器：修改docker-compose.yml，添加volumes字段将本地配置目录挂载到容器内对应路径：

   stripe:
       image: stripe/stripe-cli
       container_name: stripe-service
       volumes:
         # Mac/Linux 路径
         - ~/.config/stripe:/root/.config/stripe
         # Windows 请替换为：
         # - %USERPROFILE%/.config/stripe:/root/.config/stripe
       command: >
         listen --forward-to http://host.docker.internal:8000/subscriptions/webhook
           --skip-update --skip-verify
       restart: unless-stopped
   

3. 简化命令参数：由于配置已从挂载的本地文件读取，无需在command中指定--api-key和--secret，容器启动时会自动使用个人持久化密钥。

内容的提问来源于stack exchange，提问作者Ahmet Yazıcı