XIU2/CloudflareSpeedTest · error

[错误] 缺少配置项 [KEY] !

Error message

[错误] 缺少配置项 [KEY] !

What it means

_READ() extracts KEY from cfst_ddns.conf (grep 'KEY=' | awk -F '=' '{print $NF}') and exits 1 at script/cfst_ddns.sh:21 when empty. KEY is the Cloudflare credential: either the Global API Key (sent as X-Auth-Key together with EMAIL, line 51) or an API Token (sent as Authorization: Bearer, line 57). Without a credential no update is possible, so the script aborts early.

Source

Thrown at script/cfst_ddns.sh:21

export PATH
# --------------------------------------------------------------
#	项目: CloudflareSpeedTest 自动更新域名解析记录
#	版本: 1.0.5
#	作者: XIU2
#	项目: https://github.com/XIU2/CloudflareSpeedTest
# --------------------------------------------------------------

_READ() {
	[[ ! -e "cfst_ddns.conf" ]] && echo -e "[错误] 配置文件不存在 [cfst_ddns.conf] !" && exit 1
	CONFIG=$(cat "cfst_ddns.conf")
	FOLDER=$(echo "${CONFIG}"|grep 'FOLDER='|awk -F '=' '{print $NF}')
	[[ -z "${FOLDER}" ]] && echo -e "[错误] 缺少配置项 [FOLDER] !" && exit 1
	ZONE_ID=$(echo "${CONFIG}"|grep 'ZONE_ID='|awk -F '=' '{print $NF}')
	[[ -z "${ZONE_ID}" ]] && echo -e "[错误] 缺少配置项 [ZONE_ID] !" && exit 1
	DNS_RECORDS_ID=$(echo "${CONFIG}"|grep 'DNS_RECORDS_ID='|awk -F '=' '{print $NF}')
	[[ -z "${DNS_RECORDS_ID}" ]] && echo -e "[错误] 缺少配置项 [DNS_RECORDS_ID] !" && exit 1
	KEY=$(echo "${CONFIG}"|grep 'KEY='|awk -F '=' '{print $NF}')
	[[ -z "${KEY}" ]] && echo -e "[错误] 缺少配置项 [KEY] !" && exit 1
	EMAIL=$(echo "${CONFIG}"|grep 'EMAIL='|awk -F '=' '{print $NF}')
	[[ -z "${EMAIL}" ]] && echo -e "[信息] 缺少配置项 [EMAIL]，由 [API 密钥] 方式转为 [API 令牌] 方式!"
	TYPE=$(echo "${CONFIG}"|grep 'TYPE='|awk -F '=' '{print $NF}')
	[[ -z "${TYPE}" ]] && echo -e "[错误] 缺少配置项 [TYPE] !" && exit 1
	NAME=$(echo "${CONFIG}"|grep 'NAME='|awk -F '=' '{print $NF}')
	[[ -z "${NAME}" ]] && echo -e "[错误] 缺少配置项 [NAME] !" && exit 1
	TTL=$(echo "${CONFIG}"|grep 'TTL='|awk -F '=' '{print $NF}')
	[[ -z "${TTL}" ]] && echo -e "[错误] 缺少配置项 [TTL] !" && exit 1
	PROXIED=$(echo "${CONFIG}"|grep 'PROXIED='|awk -F '=' '{print $NF}')
	[[ -z "${PROXIED}" ]] && echo -e "[错误] 缺少配置项 [PROXIED] !" && exit 1
}

_UPDATE() {
	# 这里可以自己添加、修改 CFST 的运行参数
	./cfst -o "result_ddns.txt"

	# 判断结果文件是否存在，如果不存在说明结果为 0
	[[ ! -e "result_ddns.txt" ]] && echo "CFST 测速结果 IP 数量为 0，跳过下面步骤..." && exit 0

View on GitHub (pinned to 1da0c025d7)

Solutions

  1. Set KEY in cfst_ddns.conf to a Cloudflare API Token (works with the empty-EMAIL Bearer path) that has Zone -> DNS -> Edit permission on the zone, or to the Global API Key if EMAIL is also set
  2. Confirm no leading '#' and no spaces around '='; tokens are opaque strings, paste them whole
  3. Keep cfst_ddns.conf out of version control since it now holds a secret (chmod 600)
  4. Re-run bash cfst_ddns.sh and check the remaining _READ checks pass

Example fix

# cfst_ddns.conf (before)
KEY=
# (after)
KEY=v1.0-24c5d1ef9b4e0f2a... (API Token)
Defensive patterns

Strategy: validation

Validate before calling

key=$(grep '^KEY=' cfst_ddns.conf | head -1 | cut -d= -f2-)
[ -n "$key" ] || { echo 'KEY empty' >&2; exit 1; }
curl -s -o /dev/null -w '%{http_code}' -H "Authorization: Bearer $key" https://api.cloudflare.com/client/v4/user/tokens/verify | grep -q 200 || echo 'token verify failed' >&2

Prevention

When it happens

Trigger: cfst_ddns.conf has a missing, commented, or valueless 'KEY=' line. The grep takes the text after the last '=' on the line, so trailing whitespace or a partial paste can also corrupt the value even when non-empty.

Common situations: User removed the key because the conf is in a repo; key pasted with stray whitespace or a truncated token after Windows editor round-trips; user filled EMAIL but forgot KEY (or vice versa) and misreads which one is missing.

Related errors

AI-assisted analysis of XIU2/CloudflareSpeedTest@1da0c025d7 (2026-08-15). Data as JSON: /api/errors/23adda4424898476. Report an issue: GitHub.