//! 域名插件本地常量与共享内存键/值编码。 //! //! 这些原属 `ipass-core::config` 的「个性策略常量」与键前缀,在内核收窄时 //! 已下放插件自持(与 `oauth_keys` 同款处理)。值以 `refs/ipass` 权威实现为准。 use ipass_core::state; /// 共享内存键前缀:子域名 → 后端映射 pub const KEY_SUB_PREFIX: &[u8] = b"sub:"; /// 企业域名(业务域名)的 zone:**子域名 + `.` + 此后缀 = 完整对外域名**。 /// /// 与 `nginx.conf` 的「企业域名 server」严格耦合: /// `server_name ~^(?.+dm)\.mayishangshu\.cn$;` pub const ENTERPRISE_ZONE: &str = "mayishangshu.cn"; /// 临时域名审批通过后的有效期(秒)。到期仅停止转发,记录保留供查阅。 pub const TEMP_DOMAIN_TTL: i64 = 6 * 3600; /// 驳回记录保留时长,超期由 purge 清理(秒) pub const REJECTED_PURGE_TTL: i64 = 7 * 86400; /// 子域名总长上限:首字符 + 最多 61 个后续字符 pub const SUBDOMAIN_MAX_LEN: usize = 62; /// 系统保留名:不允许用户申请,避免抢占管理入口 pub const RESERVED_SUBDOMAINS: [&str; 4] = ["proxy-api", "admin", "www", "api"]; /// 自动生成子域名的形状前缀/后缀/位数 pub const SUBDOMAIN_PREFIX: &str = "i"; pub const SUBDOMAIN_SUFFIX: &str = "dm"; /// 随机数字位数。10^8 的空间,撞车概率极低 pub const SUBDOMAIN_RAND_DIGITS: usize = 8; /// 自动生成子域名时的最大重试次数(真撞上已占用的就换一个再试) pub const SUBDOMAIN_GEN_ATTEMPTS: usize = 5; // =========================================================================== // 转发映射共享内存(写穿):子域名 → 后端 // =========================================================================== // // 热路径**永不回源**:未命中即 404,所以每个写操作必须同时更新共享内存与文件 // (`domains::sync_shm`)。 /// 把一条转发映射写进共享内存。`exp == 0` 表示永不过期(long 域名)。 pub fn put_backend(subdomain: &[u8], backend: &[u8], expires_at: i64) -> bool { state::put(KEY_SUB_PREFIX, subdomain, backend, expires_at) } /// 读转发映射(带 TTL 判定)。未命中或已过期返回 None。 pub fn get_backend(subdomain: &[u8], now: i64) -> Option { state::get_live(KEY_SUB_PREFIX, subdomain, now) } /// 摘掉一条转发映射(审核拒绝 / 删除 / 过期)。 pub fn invalidate(subdomain: &[u8]) -> bool { state::remove(KEY_SUB_PREFIX, subdomain) } /// 清空全部转发映射(只清 `sub:` 前缀)。 pub fn clear_all() { state::clear_prefix(KEY_SUB_PREFIX); }