NodeLoc (domain.nodeloc.com) Reference

Provider Details

Service: Free subdomains by NodeLoc community
URL: https://domain.nodeloc.com
Root domains: loc.cc, and others
Nameservers: ns1.nodelook.com, ns2.nodelook.com (IP: [REDACTED-IP])
DNS backend: PowerDNS (has "Sync from PowerDNS" button)
Health checks: Automatic — domain gets suspended if health check fails for extended period

API Endpoints

Method	Endpoint	Auth	Purpose
POST	`/api/auth/login`	None	Login, returns JWT token
GET	`/api/domains`	Bearer	List user's domains
GET	`/api/domains` + query	Bearer	Domain details

DNS record management has NO REST API. Must use browser UI.

{
  "message": "success.login",
  "token": "[REDACTED-JWT]...<full JWT>",
  "user": {
    "id": 3375,
    "username": "[REDACTED-NAME]",
    "email": "user@example.com",
    "email_verified": false,
    "is_admin": false,
    "user_level": "normal",
    "domain_quota": 2,
    "invite_code": "...",
    "total_invites": 0,
    "successful_invites": 0,
    "status": "active",
    "created_at": "2026-07-16T10:39:49.944849Z",
    "last_login_at": "..."
  }
}

JWT is HS256. Payload: {"user_id":...,"username":"...","email":"...","is_admin":false,"exp":...,"iat":...}

Domain Response Shape

{
  "domains": [{
    "id": 4901,
    "full_domain": "[REDACTED-NAME].loc.cc",
    "root_domain": {"id": 1, "domain": "loc.cc", ...},
    "nameservers": "[\"ns1.nodelook.com\",\"ns2.nodelook.com\"]",
    "registered_at": "2026-07-16T10:52:26.925642Z",
    "expires_at": "2036-07-16T10:52:26.925642Z",
    "dns_synced": false,
    "auto_renew": false,
    "first_failed_at": "2026-07-16T16:03:45.845029Z"
  }]
}

DNS Record States

Status	Chinese	Meaning
`已同步`	Synced	Record active and propagated
`待处理`	Pending	Record submitted but not yet synced to PowerDNS

Domain Statuses

Status	Meaning
`suspended`	Health check failed repeatedly. Domain will be auto-deleted in ~19 days if not fixed.
`active`	Normal operation

Health Check Behavior

Runs periodically against the domain
Checks if the domain resolves AND responds
After repeated failures: domain gets suspended
After suspension: ~19 days until auto-deletion
Adding a valid A record + making the server respond fixes the health check

Login → Dashboard (/)
"我的域名" → Domain list
Click domain → Domain detail (status, health, DNS button)
"DNS" button → DNS management page with record table
"添加 DNS 记录" → Add record dialog

DNS Record Form

Name: @ (root) or subdomain name
Type: A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA
Value: IP or hostname
TTL: seconds (default 3600)
Button: "创建" (Create) — may require JS click workaround

Expiration

Domains are free and expire in 20 years (2036 for domains registered in 2026). Auto-renewal is off by default.

3.1 KiB Raw Permalink Blame History