Files.md令牌系统深度解析TOKENS_SALT与sha256如何保障同步安全【免费下载链接】files.md Private, quiet space for thinking. Simple app for .md files.项目地址: https://gitcode.com/GitHub_Trending/fi/files.mdFiles.md 是一款专注.md文件同步的轻量应用主打私密、安静的思考空间。它的多端同步能力背后是一套简洁却严谨的令牌认证系统通过TOKENS_SALT加盐的 SHA-256 哈希存储、一次性令牌one-time token交换与 IP 封禁机制在几乎没有数据库的情况下守护你的笔记安全。本文将带你从源码视角读懂这套设计。为什么 Files.md 需要令牌机制Files.md 的核心场景是你在浏览器 PWA 中编辑 markdown 笔记服务器负责在多设备间同步文件。任何一次同步请求都必须先证明我是这个用户。传统做法是用户名密码 数据库会话但 Files.md 走了一条极简路线令牌即身份哈希文件名即数据库。整个认证逻辑集中在 tokens.go 中不到 300 行代码就完成了全部鉴权。令牌生成32字节真随机数所有令牌都由genToken()生成从crypto/rand操作系统级加密随机源读取32 字节熵转为 64 位十六进制字符串作为令牌32 字节意味着 256 位密钥空间——暴力穷举在物理上不可行。这是整个安全体系的第一块基石令牌本身无法被猜测。核心机密TOKENS_SALT 与 sha256 加盐存储这是本文的主角。永久令牌从不以明文落盘服务器执行的关键操作在hashToken()中对token TokensSalt拼接后做 SHA-256 哈希用哈希值的十六进制串作为文件名文件内容只存用户 ID。也就是说磁盘上的令牌数据库长这样/opt/files.md/tokens/sha256(token salt).md→ 内容为一串用户 ID盐TOKENS_SALT在这里起三个作用防止离线爆破令牌目录一旦泄露攻击者拿到的是哈希文件名。由于令牌是 32 字节真随机数即便算出对应明文也无意义——但加盐后攻击者连这个文件名对应什么哈希输入都无法跨服务器迁移复现防止彩虹表不同服务器使用不同的TOKENS_SALT通过环境变量注入见 config.go同样的令牌在不同实例上产生完全不同的文件名无法预计算隔离多实例官方文档 docs/e2e-tests.md 明确说明了这一机制——令牌文件按sha256(标识 salt)命名源码注释里还有一句硬核的量化说明按每秒 10 亿次 SHA-256 哈希的速率暴力破解需要约 10^60 年见 tokens.go。一次性令牌Bot 链接设备的入场券Files.md 配有一个 Telegram Bot你可以直接在聊天中记录想法。要打通 Bot 与 Web 应用需要设备绑定在 Bot 中发送/app服务端调用GenOneTimeToken()生成一次性令牌并拼出?tokenxxx的 Web 链接bot.go该令牌仅存于内存oneTimeTokensmap有效期只有10 分钟浏览器打开链接后前端把令牌 POST 到/issuePermanentToken接口服务端校验后立即从内存删除——令牌一次性使用无法重放app.js交换成功后服务器签发永久令牌并写入 HttpOnly Cookie一次性令牌短命 内存 用后即焚永久令牌长寿 落盘 哈希化两者职责分离是教科书级的设计。永久令牌HttpOnly Cookie 守护 10 年交换成功后签发的永久令牌写入 Cookie配置十分讲究tokens.goHttpOnly: true—— JavaScript 无法读取XSS 偷不走令牌Secure: true—— 仅 HTTPS 传输SameSite: None—— 支持 api 域与 app 域分离的双域部署MaxAge约10 年—— 基本一次绑定长期有效每次请求经过tokenMiddleware中间件先查 Cookie兼容旧的 Authorization 头用findUserID()按sha256(token salt)文件名读盘拿到用户 ID 后才放行同步请求。完整的同步时序可参阅 docs/sync-flow.md。防御攻击者IP 封禁与只留指纹的日志Files.md 的令牌系统还有两层容易被忽略的防御️ 无效令牌即封 IP携带无效令牌的请求返回 401同时该 IP 被拉黑10 分钟期间再来的请求直接 429不再触碰业务逻辑。这是对暴力试探的直接遏制。️ 日志永不记录令牌明文调试日志 tokens_dbg.go 会把每次鉴权失败追加到/tmp/auth但对令牌只做tokenFingerprint()处理——记录长度和 SHA-256 前 8 位。源码注释直白地解释哪怕 8 个字符的前缀也足以大幅收窄暴力破解空间而指纹足以关联同一次攻击。日志本身不会成为新的泄露面。自建服务器如何正确配置 TOKENS_SALT如果你打算自部署详见 docs/your-own-server.md盐值是必填项。官方推荐的生成方式make init_server hostuserexample.com salt$(head -c 32 /dev/urandom | base64)Makefile 会将该值注入 systemd 服务的EnvironmentTOKENS_SALT$(salt)配置见 Makefile随后通过.env文件被 config.go 读取。三条部署建议✅ 盐值必须是高熵随机串不要用密码、日期这类可猜测内容✅ 盐值丢失 所有已签发令牌文件失配所有设备需重新绑定务必备份⚠️ 迁移服务器时tokens目录与盐值需一起迁移docs/your-own-server.md 的迁移章节专门提到了打包tokens.tar.gz总结小系统里的大智慧Files.md 的令牌系统用不到 300 行 Go 代码回答了无数据库如何安全认证的问题设计点实现安全收益令牌生成32 字节crypto/rand256 位熵不可猜测落盘存储sha256(token TOKENS_SALT)文件名明文不落盘防离线爆破与彩虹表设备绑定10 分钟一次性令牌用后即焚链接泄露窗口极短不可重放CookieHttpOnly Secure免疫 XSS 窃取暴力防御无效令牌封 IP 10 分钟试探成本直线上升日志审计仅记录哈希指纹日志不泄露秘密它证明了一件事安全不必靠复杂度堆砌。理解 server/sync/tokens.go 之后你也能在自己的小项目里复刻这套加盐哈希 一次性交换的轻量认证方案。【免费下载链接】files.md Private, quiet space for thinking. Simple app for .md files.项目地址: https://gitcode.com/GitHub_Trending/fi/files.md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Files.md令牌系统深度解析：TOKENS_SALT与sha256如何保障同步安全
Files.md令牌系统深度解析TOKENS_SALT与sha256如何保障同步安全【免费下载链接】files.md Private, quiet space for thinking. Simple app for .md files.项目地址: https://gitcode.com/GitHub_Trending/fi/files.mdFiles.md 是一款专注.md文件同步的轻量应用主打私密、安静的思考空间。它的多端同步能力背后是一套简洁却严谨的令牌认证系统通过TOKENS_SALT加盐的 SHA-256 哈希存储、一次性令牌one-time token交换与 IP 封禁机制在几乎没有数据库的情况下守护你的笔记安全。本文将带你从源码视角读懂这套设计。为什么 Files.md 需要令牌机制Files.md 的核心场景是你在浏览器 PWA 中编辑 markdown 笔记服务器负责在多设备间同步文件。任何一次同步请求都必须先证明我是这个用户。传统做法是用户名密码 数据库会话但 Files.md 走了一条极简路线令牌即身份哈希文件名即数据库。整个认证逻辑集中在 tokens.go 中不到 300 行代码就完成了全部鉴权。令牌生成32字节真随机数所有令牌都由genToken()生成从crypto/rand操作系统级加密随机源读取32 字节熵转为 64 位十六进制字符串作为令牌32 字节意味着 256 位密钥空间——暴力穷举在物理上不可行。这是整个安全体系的第一块基石令牌本身无法被猜测。核心机密TOKENS_SALT 与 sha256 加盐存储这是本文的主角。永久令牌从不以明文落盘服务器执行的关键操作在hashToken()中对token TokensSalt拼接后做 SHA-256 哈希用哈希值的十六进制串作为文件名文件内容只存用户 ID。也就是说磁盘上的令牌数据库长这样/opt/files.md/tokens/sha256(token salt).md→ 内容为一串用户 ID盐TOKENS_SALT在这里起三个作用防止离线爆破令牌目录一旦泄露攻击者拿到的是哈希文件名。由于令牌是 32 字节真随机数即便算出对应明文也无意义——但加盐后攻击者连这个文件名对应什么哈希输入都无法跨服务器迁移复现防止彩虹表不同服务器使用不同的TOKENS_SALT通过环境变量注入见 config.go同样的令牌在不同实例上产生完全不同的文件名无法预计算隔离多实例官方文档 docs/e2e-tests.md 明确说明了这一机制——令牌文件按sha256(标识 salt)命名源码注释里还有一句硬核的量化说明按每秒 10 亿次 SHA-256 哈希的速率暴力破解需要约 10^60 年见 tokens.go。一次性令牌Bot 链接设备的入场券Files.md 配有一个 Telegram Bot你可以直接在聊天中记录想法。要打通 Bot 与 Web 应用需要设备绑定在 Bot 中发送/app服务端调用GenOneTimeToken()生成一次性令牌并拼出?tokenxxx的 Web 链接bot.go该令牌仅存于内存oneTimeTokensmap有效期只有10 分钟浏览器打开链接后前端把令牌 POST 到/issuePermanentToken接口服务端校验后立即从内存删除——令牌一次性使用无法重放app.js交换成功后服务器签发永久令牌并写入 HttpOnly Cookie一次性令牌短命 内存 用后即焚永久令牌长寿 落盘 哈希化两者职责分离是教科书级的设计。永久令牌HttpOnly Cookie 守护 10 年交换成功后签发的永久令牌写入 Cookie配置十分讲究tokens.goHttpOnly: true—— JavaScript 无法读取XSS 偷不走令牌Secure: true—— 仅 HTTPS 传输SameSite: None—— 支持 api 域与 app 域分离的双域部署MaxAge约10 年—— 基本一次绑定长期有效每次请求经过tokenMiddleware中间件先查 Cookie兼容旧的 Authorization 头用findUserID()按sha256(token salt)文件名读盘拿到用户 ID 后才放行同步请求。完整的同步时序可参阅 docs/sync-flow.md。防御攻击者IP 封禁与只留指纹的日志Files.md 的令牌系统还有两层容易被忽略的防御️ 无效令牌即封 IP携带无效令牌的请求返回 401同时该 IP 被拉黑10 分钟期间再来的请求直接 429不再触碰业务逻辑。这是对暴力试探的直接遏制。️ 日志永不记录令牌明文调试日志 tokens_dbg.go 会把每次鉴权失败追加到/tmp/auth但对令牌只做tokenFingerprint()处理——记录长度和 SHA-256 前 8 位。源码注释直白地解释哪怕 8 个字符的前缀也足以大幅收窄暴力破解空间而指纹足以关联同一次攻击。日志本身不会成为新的泄露面。自建服务器如何正确配置 TOKENS_SALT如果你打算自部署详见 docs/your-own-server.md盐值是必填项。官方推荐的生成方式make init_server hostuserexample.com salt$(head -c 32 /dev/urandom | base64)Makefile 会将该值注入 systemd 服务的EnvironmentTOKENS_SALT$(salt)配置见 Makefile随后通过.env文件被 config.go 读取。三条部署建议✅ 盐值必须是高熵随机串不要用密码、日期这类可猜测内容✅ 盐值丢失 所有已签发令牌文件失配所有设备需重新绑定务必备份⚠️ 迁移服务器时tokens目录与盐值需一起迁移docs/your-own-server.md 的迁移章节专门提到了打包tokens.tar.gz总结小系统里的大智慧Files.md 的令牌系统用不到 300 行 Go 代码回答了无数据库如何安全认证的问题设计点实现安全收益令牌生成32 字节crypto/rand256 位熵不可猜测落盘存储sha256(token TOKENS_SALT)文件名明文不落盘防离线爆破与彩虹表设备绑定10 分钟一次性令牌用后即焚链接泄露窗口极短不可重放CookieHttpOnly Secure免疫 XSS 窃取暴力防御无效令牌封 IP 10 分钟试探成本直线上升日志审计仅记录哈希指纹日志不泄露秘密它证明了一件事安全不必靠复杂度堆砌。理解 server/sync/tokens.go 之后你也能在自己的小项目里复刻这套加盐哈希 一次性交换的轻量认证方案。【免费下载链接】files.md Private, quiet space for thinking. Simple app for .md files.项目地址: https://gitcode.com/GitHub_Trending/fi/files.md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考