Skip to content

用户权限

离线模式

离线模式不建立在线会话,可导入本地文件并使用阅读器功能。当前没有基于游客身份实施书籍数量配额或 VIP 高级设置限制。

Node 在线 API

登录接口公开;注册接口也公开。登录成功后服务端签发有效期 1 小时的 JWT,客户端通过 Authorization: Bearer <token> 访问受保护接口。JWT 中标识用户邮箱;每次授权时 Node 服务会从数据库读取当前用户和角色。令牌过期后需重新登录。

权限类别是实现层面的操作授权,不是订阅套餐:

操作 未登录 已登录普通用户 管理员
注册、登录 允许 允许 允许
浏览列表、搜索、读取评论 不允许调用受保护 API 允许 允许
读取书籍详情并记录用户下载 不允许 允许 允许
读取/修改本人资料和书架 不允许 仅本人 允许管理权限范围内访问
发布评论 不允许 允许 允许
修改/删除评论 不允许 本人评论 允许
新增/删除书籍、批量上传 不允许 不允许 允许
用户、书籍、评论及统计管理 API 不允许 不允许 允许

实际 API 中,书籍列表和搜索也位于 JWT 验证中间件之后,因此需要有效登录。具体路径与授权中间件见 Node 仓库的 src/routes/api.js 和 src/middlewares/authorization.js。

角色与安全

数据库 user.role 值为 admin 时被视为管理员,其他值按普通用户处理。不要只依赖前端隐藏按钮;所有敏感 API 都必须由服务端验证 JWT、角色和资源所有权。

密码使用 scrypt 哈希存储;生产部署需配置强随机 JWT_SECRET 并通过 HTTPS 传输。不要将 token 放进 URL 查询参数,也不要把角色当作客户端可信输入。

未实现的权限模型

当前没有 free/vip 订阅、付费校验、用户书籍数量配额、离线授权等级或按等级开放高级设置。数据库中的 price 字段不构成付费功能。阅读器中存在 VIP 升级提示弹窗,但没有对应的支付和服务端授权实现。