安装指南

系统要求

在安装之前,请确保你的系统满足以下要求:

操作系统: Windows 7 及以上版本
磁盘空间: 至少 50MB 可用空间
网络连接: 需要访问 DistroMate 服务器

安装方式

DistroMate CLI 提供了多种安装方式,你可以根据自己的需求选择最合适的方式。

方式一: 下载可执行文件 (推荐)

这是最简单快捷的安装方式,适合大多数用户。

1. 下载

从 GitHub Releases 页面下载最新版本的 distromate-cli.exe。

你也可以使用命令行下载(需要安装 curl 或 wget):

# 使用 curl
curl -L -o distromate-cli.exe https://github.com/your-org/distromate-cli/releases/latest/download/distromate-cli.exe

# 使用 wget
wget https://github.com/your-org/distromate-cli/releases/latest/download/distromate-cli.exe

2. 验证文件

下载完成后,建议验证文件的完整性:

# 查看文件信息
dir distromate-cli.exe

# 计算 MD5 校验和
certutil -hashfile distromate-cli.exe MD5

对比下载页面提供的 MD5 值,确保文件未被篡改。

3. 重命名(可选)

为了使用更简短的命令,你可以将文件重命名:

ren distromate-cli.exe distromate.exe

方式二: 添加到系统 PATH

为了能在任意目录下使用 distromate 命令,建议将其添加到系统 PATH 环境变量中。

选项 A: 通过 GUI 设置

创建专用目录:
```
mkdir "C:\Program Files\DistroMate"
```

将 distromate-cli.exe 移动到该目录:

move distromate-cli.exe "C:\Program Files\DistroMate\"

添加到 PATH:
- 右键点击「此电脑」→「属性」
- 点击「高级系统设置」
- 点击「环境变量」
- 在「系统变量」中找到「Path」,点击「编辑」
- 点击「新建」,添加 C:\Program Files\DistroMate
- 依次点击「确定」保存所有设置
重启命令行窗口使更改生效

选项 B: 通过 PowerShell 设置

使用管理员权限运行 PowerShell:

# 创建目录
New-Item -ItemType Directory -Path "C:\Program Files\DistroMate" -Force

# 移动文件
Move-Item -Path "distromate-cli.exe" -Destination "C:\Program Files\DistroMate\"

# 添加到系统 PATH
$oldPath = [Environment]::GetEnvironmentVariable('Path', 'Machine')
$newPath = $oldPath + ';C:\Program Files\DistroMate'
[Environment]::SetEnvironmentVariable('Path', $newPath, 'Machine')

# 刷新当前会话的环境变量
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine")

方式三: 使用包管理器

如果你使用 Chocolatey 或 Scoop 等包管理器,可以通过它们安装:

使用 Chocolatey

choco install distromate-cli

使用 Scoop

scoop bucket add distromate https://github.com/your-org/scoop-bucket
scoop install distromate-cli

注意: 包管理器方式目前可能尚未提供,请以实际情况为准。

验证安装

安装完成后,验证 DistroMate CLI 是否正确安装:

distromate --version

应该会显示类似以下的输出:

distromate version 1.0.0

如果看到版本号,说明安装成功!

你也可以查看帮助信息:

distromate --help

这会显示所有可用的命令和选项。

配置

1. 首次登录

安装完成后,首先需要登录到 DistroMate 服务器:

distromate login

系统会提示你输入用户名和密码:

Username: your-username
Password: ********
Successfully logged in as your-username

登录成功后,访问令牌会保存在用户主目录的 .distromate 文件中。

2. 配置 API 服务器(可选)

如果你使用的是自建服务器或私有部署,需要配置 API 服务器地址:

distromate login --api-base https://your-api-server.com

你也可以通过环境变量设置:

set DISTROMATE_API_BASE=https://your-api-server.com

在 PowerShell 中:

$env:DISTROMATE_API_BASE="https://your-api-server.com"

3. 验证配置

检查你的登录状态和配置:

distromate status

应该会显示类似以下的输出:

Logged in as: your-username
User ID: 123456
Email: your-email@example.com

Current Project:
  App ID: b66ace14
  Name: 我的应用
  Description: 应用描述

更新

检查更新

查看是否有新版本可用:

distromate version

手动更新

从 Releases 页面下载最新版本
替换旧的可执行文件
验证更新:
```
distromate --version
```

使用包管理器更新

如果你使用包管理器安装,可以直接更新:

# Chocolatey
choco upgrade distromate-cli

# Scoop
scoop update distromate-cli

卸载

手动卸载

删除可执行文件:

del "C:\Program Files\DistroMate\distromate-cli.exe"

从 PATH 中移除目录(参考添加 PATH 的步骤,执行相反操作)
删除配置文件(可选):
```
del %USERPROFILE%\.distromate
```

使用包管理器卸载

# Chocolatey
choco uninstall distromate-cli

# Scoop
scoop uninstall distromate-cli

故障排除

命令未找到

错误信息: 'distromate' 不是内部或外部命令,也不是可运行的程序或批处理文件。

解决方法:

检查文件是否存在于指定目录
确认 PATH 环境变量已正确设置
重启命令行窗口
尝试使用完整路径运行: "C:\Program Files\DistroMate\distromate-cli.exe" --version

权限错误

错误信息: Access denied 或 权限不足

解决方法:

使用管理员权限运行命令行
检查文件和目录的权限设置
尝试安装到用户目录而不是系统目录

SSL 证书错误

错误信息: SSL certificate problem

解决方法:

检查系统时间是否正确
更新系统根证书
如果使用自签名证书,需要配置信任

网络连接问题

错误信息: Failed to connect to server

解决方法:

检查网络连接
确认防火墙设置允许 DistroMate CLI 访问网络

尝试使用代理(如果需要):

set HTTP_PROXY=http://proxy.example.com:8080
set HTTPS_PROXY=http://proxy.example.com:8080

下一步

安装完成后,你可以:

阅读快速开始指南,了解如何使用 DistroMate CLI
查看命令参考了解所有可用命令
学习配置文件的详细说明

获取帮助

如果遇到问题:

查看常见问题
在 GitHub Issues 搜索相似问题
提交新的 Issue 寻求帮助

安装指南

On this page