Windows安装yapi

### 在 Windows 上通过 Docker 部署和运行 YAPI 要在 Windows 系统上部署并运行 YAPI，需完成以下几个方面的配置： #### 1. 安装必要工具 在开始之前，需要确保已安装以下软件： - **Docker Desktop for Windows**: 可以从[Docker官网](https://www.docker.com/products/docker-desktop/)下载适用于 Windows 的版本。安装完成后，启用 WSL2 支持以便更好地兼容 Linux 容器。 - **Docker Compose**: 如果使用的 Docker 版本不自带 Compose 功能，则可以通过命令手动安装[^5]。 对于 Windows 用户来说，推荐直接使用最新版的 Docker Desktop，因为它已经集成了 Docker Compose 工具链。 #### 2. 创建 `docker-compose.yml` 文件 为了简化容器管理流程，可以创建一个 `docker-compose.yml` 文件来定义所需的服务。以下是适合于 YAPI 的基本配置示例： ```yaml version: '3' services: mongo: image: mongo:4.4 container_name: mongo-yapi restart: always environment: MONGO_INITDB_ROOT_USERNAME: admin MONGO_INITDB_ROOT_PASSWORD: admin volumes: - ./data/db:/data/db yapi: image: registry.cn-hangzhou.aliyuncs.com/anoy/yapi container_name: yapi-service ports: - "7001:7001" depends_on: - mongo entrypoint: ["npm", "run", "install-server"] working_dir: /api/vendors links: - mongo:mongo environment: REGISTRY_MONGODB_URI: mongodb://admin:admin@mongo:27017/yapi?authSource=admin ``` 此文件描述了一个 MongoDB 数据库实例以及基于该数据库构建的 YAPI 应用程序服务。注意端口映射部分 (`ports`) 将主机上的 7001 映射到容器内的相同端口号[^1]。 #### 3. 启动服务 保存上述 YAML 文件至任意目录下（比如命名为 `yapi-docker-compose.yml`），打开 PowerShell 或 CMD 并切换至此路径，执行如下指令启动所有关联的服务： ```bash docker-compose up -d ``` 这条命令会以后台模式拉取镜像、建立网络连接并且开启指定的服务进程。 如果遇到工作目录错误提示类似于 “the working directory is invalid”，请确认当前操作系统的绝对路径设置无误，并且避免混用 Git Bash 这类可能改变默认行为的 shell 终端[^3]。 #### 4. 访问 Web 界面 一旦成功启动之后，就可以通过浏览器访问地址 http://localhost:7001 来进入 YAPI 控制面板界面[^4]。 --- ### 注意事项 - 若首次运行时发现缺少某些依赖项或者报错无法正常加载页面，请尝试重新 pull 最新的官方镜像资源后再试一次。 - 对于生产环境中建议调整更多参数选项如持久化存储位置等进一步优化性能表现。