{"record":{"id":"1f1a429e22091413","repo":"XIU2/CloudflareSpeedTest","slug":"name","errorCode":null,"errorMessage":"[错误] 缺少配置项 [NAME] !","messagePattern":"\\[错误\\] 缺少配置项 \\[NAME\\] !","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"script/cfst_ddns.sh","lineNumber":27,"sourceCode":"# --------------------------------------------------------------\n\n_READ() {\n\t[[ ! -e \"cfst_ddns.conf\" ]] && echo -e \"[错误] 配置文件不存在 [cfst_ddns.conf] !\" && exit 1\n\tCONFIG=$(cat \"cfst_ddns.conf\")\n\tFOLDER=$(echo \"${CONFIG}\"|grep 'FOLDER='|awk -F '=' '{print $NF}')\n\t[[ -z \"${FOLDER}\" ]] && echo -e \"[错误] 缺少配置项 [FOLDER] !\" && exit 1\n\tZONE_ID=$(echo \"${CONFIG}\"|grep 'ZONE_ID='|awk -F '=' '{print $NF}')\n\t[[ -z \"${ZONE_ID}\" ]] && echo -e \"[错误] 缺少配置项 [ZONE_ID] !\" && exit 1\n\tDNS_RECORDS_ID=$(echo \"${CONFIG}\"|grep 'DNS_RECORDS_ID='|awk -F '=' '{print $NF}')\n\t[[ -z \"${DNS_RECORDS_ID}\" ]] && echo -e \"[错误] 缺少配置项 [DNS_RECORDS_ID] !\" && exit 1\n\tKEY=$(echo \"${CONFIG}\"|grep 'KEY='|awk -F '=' '{print $NF}')\n\t[[ -z \"${KEY}\" ]] && echo -e \"[错误] 缺少配置项 [KEY] !\" && exit 1\n\tEMAIL=$(echo \"${CONFIG}\"|grep 'EMAIL='|awk -F '=' '{print $NF}')\n\t[[ -z \"${EMAIL}\" ]] && echo -e \"[信息] 缺少配置项 [EMAIL]，由 [API 密钥] 方式转为 [API 令牌] 方式!\"\n\tTYPE=$(echo \"${CONFIG}\"|grep 'TYPE='|awk -F '=' '{print $NF}')\n\t[[ -z \"${TYPE}\" ]] && echo -e \"[错误] 缺少配置项 [TYPE] !\" && exit 1\n\tNAME=$(echo \"${CONFIG}\"|grep 'NAME='|awk -F '=' '{print $NF}')\n\t[[ -z \"${NAME}\" ]] && echo -e \"[错误] 缺少配置项 [NAME] !\" && exit 1\n\tTTL=$(echo \"${CONFIG}\"|grep 'TTL='|awk -F '=' '{print $NF}')\n\t[[ -z \"${TTL}\" ]] && echo -e \"[错误] 缺少配置项 [TTL] !\" && exit 1\n\tPROXIED=$(echo \"${CONFIG}\"|grep 'PROXIED='|awk -F '=' '{print $NF}')\n\t[[ -z \"${PROXIED}\" ]] && echo -e \"[错误] 缺少配置项 [PROXIED] !\" && exit 1\n}\n\n_UPDATE() {\n\t# 这里可以自己添加、修改 CFST 的运行参数\n\t./cfst -o \"result_ddns.txt\"\n\n\t# 判断结果文件是否存在，如果不存在说明结果为 0\n\t[[ ! -e \"result_ddns.txt\" ]] && echo \"CFST 测速结果 IP 数量为 0，跳过下面步骤...\" && exit 0\n\n\tCONTENT=$(sed -n \"2,1p\" result_ddns.txt | awk -F, '{print $1}')\n\tif [[ -z \"${CONTENT}\" ]]; then\n\t\techo \"CFST 测速结果 IP 数量为 0，跳过下面步骤...\"\n\t\texit 0\n\tfi","sourceCodeStart":9,"sourceCodeEnd":45,"githubUrl":"https://github.com/XIU2/CloudflareSpeedTest/blob/1da0c025d7b6f9bf0b2b0cf47a547f65430deab2/script/cfst_ddns.sh#L9-L45","documentation":"_READ() extracts NAME from cfst_ddns.conf (grep 'NAME=' | awk -F '=' '{print $NF}') and exits 1 at script/cfst_ddns.sh:27 when empty. NAME is the DNS record's hostname, interpolated unquoted into the PUT JSON — \"name\":\"${NAME}\" (lines 53/59) — and Cloudflare validates it against the record being modified.","triggerScenarios":"cfst_ddns.conf has a missing, commented, or empty 'NAME=' line.","commonSituations":"User forgot to fill the hostname; entered a bare subdomain ('ddns') instead of the FQDN ('ddns.example.com') which Cloudflare then normalizes or rejects; changed the subdomain later without updating the conf. NAME contains dots but no '=', so the last-field awk extraction is safe.","solutions":["Set NAME to the FQDN of the record whose ID is in DNS_RECORDS_ID, e.g. NAME=ddns.example.com","Confirm the name matches what Cloudflare shows for that record (zone apex is @ -> example.com)","Check the line is uncommented with no spaces around '='","Re-run and verify _READ completes"],"exampleFix":"# cfst_ddns.conf (before)\nNAME=\n# (after)\nNAME=ddns.example.com","handlingStrategy":"validation","validationCode":"name=$(grep '^NAME=' cfst_ddns.conf | head -1 | cut -d= -f2-)\n[[ $name =~ ^[a-zA-Z0-9._-]+\\.[a-zA-Z]{2,}$ ]] || { echo \"NAME not an FQDN: '$name'\" >&2; exit 1; }","typeGuard":"is_fqdn(){ [[ $1 =~ ^[a-zA-Z0-9._-]+\\.[a-zA-Z]{2,}$ ]]; }","tryCatchPattern":null,"preventionTips":["Always write the FQDN (ddns.example.com), matching the record shown in the dashboard","Keep NAME and DNS_RECORDS_ID in sync — the id points at one name; a mismatch gets HTTP 400","Dry-run the PUT with curl once to let Cloudflare validate name/type before cron depends on it"],"tags":["shell","bash","cloudflare","ddns","configuration","dns"],"backgroundTag":null,"analyzedSha":"1da0c025d7b6f9bf0b2b0cf47a547f65430deab2","analyzedAt":"2026-08-15T22:22:10.737Z","schemaVersion":2},"datasetVersion":"2026-08-16T03:17:38.424Z"}