React-Native连接本地Docker部署的Appwrite实例遇异常求助

可能原因 #

• 网络环境差异：浏览器直接使用宿主机网络栈，而客户端（如移动端、桌面程序）可能处于独立网络命名空间，导致localhost指向客户端自身而非宿主机；IP超时则大概率是Docker端口未正确对外暴露，或宿主机防火墙拦截了请求。
• Docker端口映射错误：Appwrite容器的端口仅绑定到127.0.0.1，而非0.0.0.0，导致局域网设备无法访问。
• Appwrite主机名配置不当：_APP_HOSTNAME环境变量设置为容器内部地址，外部请求无法正确路由到容器服务。

解决步骤 #

1. 修正Docker端口映射 #

打开Appwrite部署目录下的docker-compose.yml，调整端口映射配置，确保容器80端口绑定到宿主机所有网卡：

services:
  appwrite:
    ports:
      - "0.0.0.0:80:80"
      - "0.0.0.0:443:443" # 若启用HTTPS需配置

保存后重启容器：

docker-compose down && docker-compose up -d

2. 适配客户端环境调整端点地址 #

• 宿主机本地客户端：优先使用http://127.0.0.1/v1替代http://localhost/v1，部分客户端对localhost的解析存在兼容性问题；同时验证宿主机80端口是否被容器占用：

  # Linux/macOS
  netstat -anp | grep :80
  # Windows
  netstat -ano | findstr :80
  

• 移动端/局域网设备：必须使用宿主机的局域网IP（如192.168.1.100）作为端点，同时开放宿主机防火墙80端口：

  # Ubuntu/Debian
  sudo ufw allow 80/tcp
  # CentOS/RHEL
  sudo firewall-cmd --add-port=80/tcp --permanent
  sudo firewall-cmd --reload
  

3. 配置Appwrite主机名 #

在docker-compose.yml的environment区域，设置_APP_HOSTNAME为宿主机局域网IP或0.0.0.0：

environment:
  - _APP_HOSTNAME=192.168.1.100 # 替换为你的宿主机实际IP

重启容器使配置生效。

4. 排查客户端网络权限 #

• 移动端APP：确认已授予网络访问权限，且设备与宿主机处于同一Wi-Fi网络。
• 桌面客户端：临时关闭防火墙或安全软件，测试请求是否恢复正常，排除拦截问题。

内容的提问来源于stack exchange，提问作者Lakmal