Lando项目在企业网络环境下SSL证书问题的解决方案

问题背景

在使用Lando进行本地开发环境搭建时，部分开发者可能会遇到SSL证书验证失败的问题。这类问题通常出现在企业网络环境中，特别是那些使用了中间人安全检测工具（如Zscaler）的场景。

错误现象

开发者在使用Lando启动项目时，可能会遇到以下错误信息：

PHP Warning: copy(): SSL operation failed with code 1. OpenSSL Error messages:
error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed

这表明系统无法验证远程服务器的SSL证书，导致无法正常下载依赖项（如Composer安装器）。

根本原因

在企业网络环境中，安全设备通常会拦截HTTPS流量并重新加密，这会导致：

1. 本地开发环境无法识别企业安全设备提供的中间证书
2. 证书链验证失败
3. 依赖项下载过程中断

解决方案

方法一：添加企业根证书

1. 首先获取企业网络的根证书（通常可从IT部门获取或从浏览器导出）
2. 将证书文件放置在项目根目录下（如lando-ca.crt）
3. 修改lando.yml配置文件，添加以下内容：

services:
  appserver:
    overrides:
      environment:
        # 设置环境变量指向自定义证书
        NODE_EXTRA_CA_CERTS: /lando/certificates/lando-ca.crt
        GIT_SSL_CAINFO: /lando/certificates/lando-ca.crt
    build_as_root:
      - cp -rf /app/lando-ca.crt /usr/local/share/ca-certificates/
      - update-ca-certificates

方法二：调整特定证书验证（不推荐）

对于某些特定情况，可以调整对某些根证书的验证方式：

services:
  appserver:
    build_as_root:
      - sed 's|mozilla/AddTrust_External_Root.crt|#mozilla/AddTrust_External_Root.crt|g' -i /etc/ca-certificates.conf
      - update-ca-certificates

最佳实践建议

1. 优先使用方法一：添加企业证书是更安全、更持久的解决方案
2. 与IT部门协作：获取正确的企业根证书文件
3. 定期更新证书：企业证书可能会更新，需要及时同步
4. 项目文档化：在团队文档中记录这些配置，方便新成员快速上手

注意事项

1. 调整证书配置后，需要执行lando rebuild使更改生效
2. 不同企业网络环境可能需要不同的配置方式
3. 对于Firefox用户，可能需要额外的配置步骤

通过以上方法，开发者可以在企业网络环境下顺利使用Lando进行本地开发，而不会遇到SSL证书验证失败的问题。