windows 安装apisix dashboard

### 安装和配置 Apisix Dashboard 对于希望在 Windows 系统上安装和配置 Apisix Dashboard 的用户来说，由于官方文档主要针对 Linux 和 macOS 提供详细的指导说明[^1]，因此需要采取一些额外措施来适应 Windows 平台。 #### 使用 WSL 或 Docker 方案 考虑到原生支持有限，在 Windows 上推荐采用两种主流方案之一： - **WSL (Windows Subsystem for Linux)**：利用此功能可以在 Windows 中运行完整的 Linux 环境而无需修改主机操作系统。这使得能够按照标准流程执行基于 Unix/Linux 的命令集来进行 Apisix 及其仪表板的部署。 - **Docker**：另一种方法是借助容器化技术 Docker 来简化跨平台开发环境的一致性问题。通过拉取预构建镜像文件快速搭建起所需的全部依赖关系和服务实例。 #### 准备工作 无论选择哪种途径，都需要先完成如下准备工作： - 对于 WSL 用户而言，需确保已启用该特性并通过 Microsoft Store 获取合适的发行版； - 如果倾向于使用 Docker，则应前往官方网站下载适用于 Windows 版本的应用程序并依照指示完成设置过程； #### 配置 Etcd Etcd 是一个分布式键值存储系统，用于保存集群数据状态信息。为了使 Apisix 正常运作，必须事先准备好至少一个可用节点作为后端数据库连接目标。可以通过以下任一方式进行初始化操作： ```bash # 基于 Homebrew（仅限 Mac OS） brew install etcd # 利用 apt-get （Debian/Ubuntu 类 Linux 发行版本） sudo apt update && sudo apt install -y etcd # 从源码编译或直接获取二进制分发包... ``` 请注意上述指令并不完全兼容 Windows，默认情况下建议考虑将 Etcd 运行在一个独立虚拟机内或是同样依靠 Docker 实现隔离化的管理维护模式。 #### 启动 Apisix-Dashboard 一旦前置条件满足之后，就可以着手准备启动 Apisix-Dashboard 应用了。假设已经成功设置了 WSL/Docker，并且有可访问的 Etcd 资源存在的话，那么接下来的操作步骤大致相同： ##### 方法 A: 通过 Git Clone & 手动构建 如果决定走传统路线即手动克隆仓库再自行打包发布的方式，请参照下面给出的具体做法： ```bash git clone https://github.com/apache/apisix-dashboard.git $HOME/apisix-dashboard cd $HOME/apisix-dashboard make build docker-compose up -d --build ``` 以上命令序列会依次完成项目检出、本地资源整理以及最终的服务上线动作。当然实际执行过程中可能还需要根据提示调整部分参数选项以适配特定场景下的需求差异。 ##### 方法 B: 单纯运用 Docker Compose 文件 更简便的办法莫过于直接调用预先编写好的 `docker-compose.yml` 描述模板一键搞定整个架构体系的建立： ```yaml version: '3' services: apisix: image: apache/apisix:latest-alpine ports: - "9080:9080" - "9443:9443" environment: APISIX_ADMIN_KEY: edd1c9f034335f136f87ad84b625c8f1 ETCD_HOSTS: http://${ETCD_IP}:2379 dashboard: image: apachecn/apisix-dashboard:latest depends_on: - apisix ports: - "9000:9000" ``` 只需简单替换 `${ETCD_IP}` 处的内容指向真实的 Etcd 地址即可实现无缝衔接的效果。随后只要正常启动关联容器就能立即体验到图形界面带来的便捷之处了。