Skip to main content

阿里云控制台工具 (aliyun-controller)

这是一个调用阿里云 Python SDK 的终端用户界面(TUI)工具,基于 Textual 构建,用于在终端中完成账单查询与 DNS 解析管理等常用操作。

功能特性

  • 流量统计:查询指定月份的公网流出流量(IPv4 / IPv6 / 合计),明细表格 + 20GB 免费额度双色进度条
  • 账单归纳:按产品归纳指定月份的消费金额,附消费汇总面板(总额 / 产品数 / 占比最高项)
  • DNS 管理:管理域名解析记录(含线路 / MX 优先级 / 权重 / 备注),支持搜索、排序以及增删改、启用/禁用
  • 现代化 TUI:艺术字首页、统一键位、页面内折叠菜单、状态栏与非阻塞异步加载

后续计划

  • 加入 ECS 控制 的相关内容
  • 加入 OOS 控制 的相关内容

界面与快捷键

场景 快捷键 作用
全局 Tab 切换焦点
Ctrl+Q 任意界面直接退出程序
Home / End / PgUp / PgDn 页面滚动到顶 / 底 / 翻页(焦点在文本框时自动让位给文本框)
主菜单 1 / 2 / 3 / 4 / 5 直达流量查询 / 账单归纳 / DNS 管理 / 设置 / 退出
↑ / ↓ · 回车 移动光标 · 确认
Esc / Ctrl+C 退出程序
功能页 Ctrl+R 刷新数据
Esc / Ctrl+C 返回上一级(折叠菜单打开时优先关闭菜单)
↑ / ↓ · 回车 表格内移动光标 · 操作所选行
/ 聚焦搜索框(实时模糊过滤)
← / → 月份选择器切换账期(焦点在选择器上时)
DNS 记录页 Ctrl+N / Ctrl+E / Ctrl+D 新增 / 编辑 / 删除(作用于当前行)
弹窗 Esc / Ctrl+C 取消并关闭
回车 提交表单或确认

安装指南

通过 pip 安装(推荐)

pip install aliyun-controller

安装后,可以直接使用 aliyunctl 命令运行程序:

aliyunctl

需要 Python 3.10 及以上版本。

从源码运行(开发模式)

  1. 克隆此项目到本地:

    git clone <项目地址>
    cd aliyun-controller
    
  2. 创建虚拟环境(推荐):

    python -m venv venv
    source venv/bin/activate  # Linux/Mac
    # 或在 Windows 上: venv\Scripts\activate
    
  3. 安装依赖:

    pip install -e .
    
  4. 创建阿里云 RAM 用户并授权:

    • 登录阿里云控制台。
    • 进入 RAM 访问控制。
    • 在左侧导航栏选择 用户 > 创建用户。
    • 设置登录名称和显示名称,勾选 为该用户自动生成 AccessKey。
    • 创建成功后,请务必保存好 AccessKey ID 和 AccessKey Secret,它们只显示一次。
    • 为新创建的 RAM 用户授权:
      • 在用户详情页,点击 添加权限。
      • 选择 AliyunBSSReadOnlyAccess 和 AliyunDNSFullAccess 权限。
      • 点击 确定 完成授权。
  5. 配置阿里云访问密钥: 默认情况下,程序会在 ~/.config/aliyun-controller 目录下查找配置文件。 首次运行或配置文件不存在时,程序会自动进入 Textual 配置向导,依次填写:

    • access_key_id
    • access_key_secret

    填写完成后会自动生成 config.yaml。之后也可从主菜单的「设置」中随时修改访问密钥。

    你也可以使用 --dir/-D 参数指定配置文件所在的目录:

    aliyunctl -D /path/to/your/config/dir
    

使用方法

安装后,可以直接使用 aliyunctl 命令运行程序:

aliyunctl

程序将显示 Textual 交互界面,你可以选择以下功能:

  1. 流量查询:查看指定月份的公网总流出流量
  2. 账单归纳:查看指定月份按产品汇总的账单明细
  3. DNS 解析管理:管理域名解析记录
  4. 设置:查看 / 修改阿里云访问密钥

你也可以使用 --dir/-D 参数指定配置文件所在的目录:

aliyunctl -D /path/to/your/config/dir

账单查询

  • 进入后默认查询当前月份的账单
  • 顶栏的 ◀ YYYY-MM ▶ 月份选择器可逐月切换(点击月份还会弹出年份 + 12 月的快捷选择浮层),切换后自动重新查询(范围:2020-01 至当月)
  • 流量页附带 20GB 免费额度进度条:额度内绿色,超出部分红色(量程随用量自适应)
  • 查询在后台线程执行,界面不会阻塞;结果以汇总面板 + 明细表格展示

DNS 管理

  • 选择要管理的域名,进入解析记录列表(新增「线路」列,显示默认 / 电信 / 联通等线路)
  • 支持按主机记录 / 记录值 / 线路模糊筛选
  • 支持按创建时间、二级域名、首字母排序(正序 / 逆序)
  • 回车可对所选记录执行编辑、启用 / 禁用、删除操作,并可新增记录
  • 支持的记录类型:A、AAAA、CNAME、MX、TXT、NS、SRV、CAA、ALIAS、SVCB、HTTPS、TLSA、显性 URL、隐性 URL
  • 新增 / 编辑表单支持:解析线路(一级线路下拉 + 「更多线路…」可搜索全量线路)、MX 优先级、权重(0–100)、备注(≤50 字符)、TTL(1–86400 秒)
  • 复合记录值使用结构化输入:SRV 4 栏、CAA 3 栏、TLSA 4 栏、SVCB / HTTPS 3 栏、显性 URL 2 栏;提交时自动拼成 API 需要的 Value
  • 限制:
    • 权重仅 A / AAAA / CNAME / ALIAS,且同一主机记录 + 同一线路下至少 2 条可加权记录(同名的 TXT/MX 等不计入);0 表示不参与返回(服务端可能拒绝)
    • URL 转发(显性 / 隐性)仅支持默认线路,主机记录不支持泛解析与下划线
    • ALIAS 仅企业旗舰版 / 尊享版可用,且与 DNSSEC 互斥
    • TTL 最小 1 秒,但免费版 / 个人版实际最小 600 秒
  • 控制台有但 OpenAPI 做不到:单条记录内「记录值集合」的逐行启停;记录锁定 / 解锁(Locked 只读)

权限要求

为了正常使用所有功能,你的阿里云 RAM 用户记得开放以下权限:

  • AliyunBSSReadOnlyAccess:用于账单查询
  • AliyunDNSFullAccess:用于 DNS 管理

开发

本项目遵循 Python 3.10+ 规范。

git clone https://github.com/Moha-Master/Aliyun-Controller.git
cd Aliyun-Controller
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

许可证

MIT

Metadata

Release files for aliyun-controller 0.2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aliyun-controller 0.2.6
File Size Uploaded Provenance Actions
aliyun_controller-0.2.6.tar.gz 56.4 kB Without provenance Details for aliyun_controller-0.2.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aliyun-controller 0.2.6
File Interpreter ABI Platform Actions
aliyun_controller-0.2.6-py3-none-any.whl Python 3 none any Details for aliyun_controller-0.2.6-py3-none-any.whl

Total release size: 116.4 kB

Release files / aliyun_controller-0.2.6.tar.gz

Download URL aliyun_controller-0.2.6.tar.gz
Size 56.4 kB
Tags Source
SHA-256 checksum
How to use checksums
0ac72b3402dd3479f476d72b676a55de97119ae8a29040beb11df43d2429fd94
BLAKE2b-256 checksum
How to use checksums
1b4ff2ad19b1d5d7652af8285d90a00f5b85dcfb38a3c8aeaf1b53909600fc07
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Release files / aliyun_controller-0.2.6-py3-none-any.whl

Download URL aliyun_controller-0.2.6-py3-none-any.whl
Size 60.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a56c098464f1f9cc6346125e21225de8cb892e031418f9ebf6e0e33923293746
BLAKE2b-256 checksum
How to use checksums
a1fa8043fe569b3b88bbdf81024546a9950edeea8a06fb6df803e3d3327f666d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Security for aliyun-controller 0.2.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page