# 后台在哪里打开下载站

> 一句话：后台有**两个**入口 —— 右上角顶部的 **📥 下载站**（任何页面都能点），
> 以及「🔄 系统升级 → 📥 下载更新包」（在升级操作旁边）。
> 这是 1.1.25 新增的功能，不用再记域名、也不用来回切页面。

## 入口一：顶部导航的「📥 下载站」

位置在后台**右上角**，就在「打开网页版」旁边：

```
📊 后台管理                    打开网页版 · 📥 下载站 · 刷新数据 · 退出
```

点一下**新窗口打开**下载站，随时取包。**它不依赖任何配置** —— 不管你在哪个页面、
有没有填过下载站地址，这个按钮永远能用。

## 入口二：「系统升级」页的「📥 下载更新包」

在后台左侧点「🔄 系统升级」，页面中间会出现一个 **📥 下载更新包** 区块，
位置正好夹在「📦 可用升级」和「📋 版本升级清单」之间 —— 取包和升级的操作挨在一起，
顺手就能点到。

区块里有三个按钮：

| 按钮 | 作用 |
| --- | --- |
| 🌐 **打开下载站** | 新窗口打开对外下载站，拿最新安装包 / 升级包 |
| 📋 **复制地址** | 把下载站地址复制到剪贴板，方便发给同事 |
| 🔄 **刷新版本信息** | 当场读一下下载站上现在挂的是哪一版 |

点「刷新版本信息」后会显示一张小表：

```
应用版本      1.1.25
当前升级包    avc-upgrade-20261013-v41.zip
包大小        515.6 KB
发布时间      2026-10-13 14:39:01
SHA256        971d99b8c70623bac18ccc0274dda725668507971d83142df87d0a418db7333d
```

**这个表是干嘛用的？** 发版前后对一眼，确认「我要装的」和「线上挂的」是同一个包 ——
版本号、文件名、哈希都对得上，就不用担心装错包。

### 两个入口的区别

| | 顶部「📥 下载站」 | 升级页「🌐 打开下载站」 |
| --- | --- | --- |
| 位置 | 后台右上角，任何页面可见 | 「系统升级」页内 |
| 地址来源 | **固定写死**，不依赖配置 | 读「系统设置 → 下载站地址」 |
| 没配置时 | **照样能用** | 显示「去填写」引导 |
| 换域名 | 需改代码重新发版 | 后台填一下即可 |

简单说：**想在任何地方随手点就用顶部那个；想让地址跟着站点配置走就用升级页那个。**

## 第一次使用：填一次地址

入口需要先知道下载站地址。如果还没填，区块里会显示一段引导 + 一个「去填写」按钮，
点它就会跳到「系统设置」并把光标放到输入框上，填完点「保存」即可。

```
系统设置 → 下载站地址 →  https://你的下载站域名
```

### ⚠️ 别和「站点地址」搞混

系统设置里现在有**两个**地址字段，含义完全不同：

| 字段 | 是什么 | 用在哪 |
| --- | --- | --- |
| **站点地址** | **本站自己**的地址 | 用户访问、生成小程序二维码 |
| **下载站地址** | 存放安装包 / 升级包的**对外静态站** | 后台「打开下载站」按钮 |

两个地址通常不是一个。如果你把本站地址填到「下载站地址」里，按钮也能点，
但打开的是自己的后台而不是包列表 —— 不是想要的效果。

**留空会怎样？** 区块显示「去填写」引导，「打开下载站」按钮不出现。
这是**故意的** —— 系统不会拿本站地址去凑一个下载站，猜错比留空更麻烦。

## 常见问题

### 点「刷新版本信息」显示「读取失败」/「请求异常」

先确认「打开下载站」能不能正常打开：

- **能打开，但读不到版本** → 下载站可能是**单文件发布**（平台只托管一个
  `index.html`，没有 `latest.json`）。这种情况系统会自动降级为**读页面内容**
  解析版本号，并标注一段说明；如果页面里连版本号都没有，才会提示读不到。
- **打不开** → 地址填错了，或下载站本身挂了。检查「下载站地址」字段。

### 换了下载站地址，按钮还指向旧的

点「保存」后入口会立刻更新，不用重启服务。若页面停留在旧状态，
切一下 Tab 或刷新页面即可。

### 后台升级页打开是空白的

1.1.24 已修复：以前这个区块只在「系统设置」页渲染，用户直接点「系统升级」就会看到
空白。现在进入「系统升级」页会**自动补拉一次设置**，直接点进去也能看到。

## 为什么地址要做成可配置

下载站域名换过位置（比如从测试域切到正式域、或者换了托管平台），
写死在代码里就得改源码重新打包。做成配置后，**后台填一下就能切**，
不用动代码，也不用重新发版。

---

**相关文档**：`一键发布到OSS说明.md`（怎么把包传上去）、
`开发机一条命令发版.md`（开发机怎么一条命令走完全程）。