阿里云短信（aliyunopen）通道配置教程

网程聚合数据 2026-10-31 04:11 9 阅读通道教程

「阿里云短信」通道配置教程：开通短信服务、申请签名与模板、创建 AccessKey，在用户中心上游通道配置页保存四项配置。含必填项、签名模板留空规则与生效时间说明。

「阿里云短信」（`aliyunopen`）通道用于调用阿里云短信服务（Dysmsapi）发送短信。本通道接口按用户维度隔离凭证，你需要在用户中心填入自己的阿里云 AccessKey 与短信签名、模板，接口才会以你的账号发送短信。

本教程说明两部分内容：如何在阿里云侧准备好短信服务与 AccessKey，以及如何在用户中心的 `/member/upstream/config` 页面完成通道配置。

## 一、通道说明

- **凭证维度**：通道级。在配置页保存一次，本通道下的全部接口共用这一份凭证。
- **必填项**：AccessKeyID 与 AccessKeySecret 必须填写；默认短信签名、默认短信模版 Code 可以留空，改为每次调用时传参（详见第三节字段表）。
- **调用模式**：同步返回，不涉及任务提交、轮询与回调地址。
- **计费方式**：平台按次计费，单价见接口文档页，**只有调用成功（返回 `code` 为 0）才扣平台点数，失败不扣**；**短信本身的费用由阿里云按条收取**，需要你的阿里云账号已购买短信套餐包或开通按量付费，两边都满足才能发送成功。
- **前置条件**：短信签名与模板必须先通过阿里云审核，未审核通过时接口会返回阿里云的签名/模板非法错误。

## 二、在阿里云侧准备短信服务与 AccessKey

**第 1 步：开通短信服务。** 登录阿里云短信服务控制台 <https://dysms.console.aliyun.com/>，按提示开通服务。

**第 2 步：提交资质并申请签名、模板。** 在短信服务控制台的国内短信相关菜单中（菜单名称以控制台实际显示为准），先提交签名归属方的资质材料，再申请短信签名与短信模板，等待审核通过。

- 签名名称即短信开头【】里的内容，配置时**只填名称本身，不要带【】**。
- 模板审核通过后会得到一个 `SMS_` 开头的模板 CODE，模板正文中的变量形如 `${code}`。
- 资质要求、审核时长、签名实名报备等规则以阿里云官方文档与控制台提示为准：<https://help.aliyun.com/knowledge_list/90546.html>

**第 3 步：创建 AccessKey。** 推荐使用 RAM 用户而不是阿里云主账号：

1. 进入 RAM 控制台 <https://ram.console.aliyun.com/>，在「身份管理」→「用户」中创建（或选择）一个 RAM 用户，并允许它使用 AccessKey 访问 OpenAPI；
2. 为该用户授予短信服务的调用权限（可在授权时搜索 Dysms 相关系统策略，如 `AliyunDysmsFullAccess`）；
3. 进入用户详情页的「凭证管理」标签，在 AccessKey 区域点击**创建 AccessKey**，得到 AccessKeyID 与 AccessKeySecret。

**AccessKeySecret 只在创建时显示一次**，关闭弹窗后无法再次查看，请立即复制保存；遗失只能重新创建一对新的 AccessKey。

> 官方步骤参考：<https://help.aliyun.com/zh/ram/user-guide/create-an-accesskey-pair>

> 安全提示：AccessKey 等同于你阿里云账号的程序访问凭证，泄露后他人可用它调用你已授权的云服务。请勿写入前端代码、提交到版本库或公开分享；如疑似泄露，立即在 RAM 控制台禁用或删除该 AccessKey，再创建新的并回到用户中心更新配置。

## 三、在用户中心配置通道

**第 1 步：登录用户中心。** 打开 <https://www.phpwc.cn/member/login>，用用户名或邮箱登录。

**第 2 步：进入上游通道配置页。** 直接访问 <https://www.phpwc.cn/member/upstream/config#tab-aliyunopen>，页面会自动定位到「阿里云短信」选项卡；也可以从用户中心左侧菜单展开「上游通道」→ 点击「上游通道配置」，再手动点击上方的「阿里云短信」选项卡。手动切换选项卡时，网址会自动补上对应的 `#tab-` 锚点，可直接收藏或分享该链接。

> 如果带锚点的链接打开后仍停在第一个选项卡，通常是浏览器缓存了旧版页面，按 `Ctrl+Shift+R` 强制刷新一次即可。

**第 3 步：填写配置项。**

| 字段 | 是否必填 | 填写说明 |
|---|---|---|
| AccessKeyID | 必填 | 上一步创建的 AccessKeyID，注意不要带空格或换行 |
| AccessKeySecret | 必填 | 与 AccessKeyID 配对的 Secret，仅创建时可见 |
| 默认短信签名 | 选填 | 审核通过的签名名称，不带【】。填写后调用时可不传 `sign_name` |
| 默认短信模版Code | 选填 | `SMS_` 开头的模板 CODE。填写后调用时可不传 `template_code` |

> 页面上这四个输入框都没有标红色星号，但**AccessKeyID 与 AccessKeySecret 实际上是必填的**：四项全空也能保存成功，调用时却会报「阿里云门户 AccessKey 为空」。签名与模板 Code 则允许长期留空，只要在每次调用时通过 `sign_name`、`template_code` 参数传入即可；两处都没有值时会报「短信签名未配置」或「短信模板 Code 未配置」。

**第 4 步：保存。** 点击**保存配置**，看到「配置已保存」提示即完成（提示约 3 秒后自动消失）。配置为覆盖式保存，之后更换 AccessKey 或默认签名/模板重新提交一次即可；本页没有「删除/清空配置」按钮。

**第 5 步：生效时间。** 保存动作会立即清除凭证缓存，正常情况下即时生效。由于服务以多进程方式运行，个别情况下其他进程的缓存需要等待自动过期，最长约 10 分钟。

常见问题

Q：配置页四个字段都要填吗？签名和模板能不能每次调用时再传？

A：AccessKeyID 与 AccessKeySecret 实际必填，但页面上四项都没有红色星号，四项全空也能保存成功，保存后接口却无法使用。默认短信签名与默认短信模版Code 可以长期留空，改为每次调用时传 sign_name、template_code；两处都没有值时同样无法发送。

Q：AccessKey 用主账号还是 RAM 用户？签名模板有什么前置条件？

A：建议用 RAM 用户创建 AccessKey 并只授予短信服务权限，AccessKeySecret 仅在创建时显示一次，需当场复制保存。签名与模板必须先提交并审核通过，且 AccessKey 所属账号要与签名归属账号一致；签名只填【】里的名称本身，模板 CODE 以 SMS_ 开头，正文变量形如 ${code}。

Q：保存后多久生效？更换 AccessKey 或默认签名要怎么操作？

A：看到「配置已保存」提示即写入成功。保存动作会立即清除凭证缓存，正常情况下即时生效，个别服务进程的缓存最长约 10 分钟自动过期。配置为覆盖式保存，更换 AccessKey、默认签名或模板 Code 时重新提交一次即可，本页没有删除按钮。

通道配置阿里云短信短信验证码 API集成凭证配置

上一篇：高德开放平台（amap）通道配置教程下一篇：阿里云市场（market）通道配置教程

网友评论（0）

暂无评论，快来抢沙发～