升级机器重装后无法登录/注册Appwrite控制台求助

结合你升级机器重装组件后出现的问题，以及使用Docker 4.16.3的环境，可按以下步骤排查修复：

1. 检查核心容器运行状态 #

先确认Appwrite关键容器是否正常启动：

docker ps

重点查看appwrite-api、appwrite-auth、appwrite-mariadb这几个容器的状态。如果有容器退出或异常，通过日志定位具体错误：

docker logs <异常容器的ID或名称>

2. 核对环境变量关键配置 #

重装后容易出现环境变量配置丢失或错误，检查appwrite/.env文件里的核心参数：

• _APP_OPENSSL_KEY_V1：该密钥是用户会话、JWT验证的核心，若重装时未沿用旧密钥，会导致原有凭证失效，新用户注册也可能失败。全新部署可重新生成，需保留原有数据则必须使用旧密钥。
• _APP_DATABASE_HOST、_APP_DATABASE_USER、_APP_DATABASE_PASS：确认数据库连接参数正确，保证appwrite-mariadb容器可正常访问。
• _APP_DOMAIN：确保配置的域名和实际访问控制台的域名一致，避免跨域或回调地址错误。

3. 排查Docker网络连通性 #

升级机器后Docker网络可能出现异常，确认所有Appwrite容器处于同一自定义网络：

docker network ls
docker inspect appwrite # 默认网络名称为appwrite，可根据实际情况调整

检查输出里的Containers字段，确认api、auth、mariadb等容器都已加入该网络，且容器间能互相ping通。

4. 检查端口占用情况 #

确认Appwrite默认使用的端口（80、443、3000等）未被其他服务占用：

lsof -i :80
lsof -i :443

若存在端口冲突，修改docker-compose.yml中的端口映射配置，或停止占用端口的服务。

5. 重新初始化Appwrite配置（全新部署可选） #

若无需保留原有数据，可清理旧数据卷后重新部署：

docker-compose down -v
docker system prune -f
# 重新执行Appwrite安装命令
docker run -it --rm \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="install" \
    appwrite/appwrite:latest

注意：-v参数会删除所有关联数据卷，包括数据库数据，需谨慎操作。

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