darkver8/cosmo-note repository overview

⁠🌌 Cosmo Note (星脉笔记)

• 🌐 在线体验 (Cloudflare): https://cosmo-note.pages.dev⁠
• 🐙 开源仓库 (GitHub): https://github.com/Swicv/note⁠
• 👨‍💻 作者主页: https://666228.xyz⁠

⁠✨ 核心特性

• 🛡️ 思源笔记式访问门禁：免去繁琐的多用户后台注册，全站由单一访问授权码（Master Access Code）守卫，即开即用。
• 🔗 单笔记独立密码公网分享：每篇笔记均可生成专属公网外链，并单独设置阅读密码（与主密码物理隔离），外部访客仅可阅读该篇，绝对无法窥视全站。
• 🌗 宇宙深空 & 日光纸白双主题：
  • 深空夜色（Dark Mode）：粒子星轨画布微动效，高质感深空黑；
  • 日光纸境（Light Mode）：高反差深炭黑与浅石板色底色，阅读排版温润柔和、不刺眼。
• ⚡ 原生多架构支持：官方镜像同时原生支持 linux/amd64 (x86_64 服务器 / PC) 与 linux/arm64 (Apple Silicon、树莓派、ARM NAS / VPS)。
• 📝 全能 Markdown / 富文本：支持实时双栏预览、代码语法高亮与一键复制代码、KaTeX 数学公式、GitHub Callouts 提示框、任务清单、全文大纲目录（TOC）。
• 🔍 全星图极速搜索：支持快捷键 Cmd/Ctrl + K 毫秒级模糊检索标题与正文段落。

⁠🚀 Docker 极速部署

⁠方式一：Docker CLI 单行一键运行（推荐）

docker run -d \
  --name cosmo-note \
  -p 3000:3000 \
  -v $(pwd)/cosmo_data:/data \
  --restart unless-stopped \
  darkver8/note:latest

启动完成后，打开浏览器访问：http://localhost:3000（或 http://<服务器IP>:3000）即可立即使用！

⁠方式二：Docker Compose 启动

创建 docker-compose.yml 文件：

version: "3.8"

services:
  cosmo-note:
    image: darkver8/note:latest
    container_name: cosmo-note
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./cosmo_data:/data
    environment:
      - PORT=3000
      - DB_PATH=/data/cosmo.db
      # - MASTER_PASSWORD=your_password  # 可选：预设主授权码，若不设则首次进入网页时引导设置
      # - JWT_SECRET=your_jwt_secret     # 可选：自定义 JWT 签名密钥

启动容器：

docker compose up -d

⁠⚙️ 环境变量说明

⁠📦 架构兼容性

本镜像通过 Docker Buildx 原生编译，支持以下平台：

• linux/amd64 (标准 64 位 Intel / AMD 服务器与 PC)
• linux/arm64 (Apple Silicon M系列, 树莓派 4/5, 飞腾/鲲鹏/Ampere ARM 云服务器与 NAS)

⁠🤝 鸣谢与支持

• 作者个人主页: https://666228.xyz⁠
• 源码与 Issue 反馈: https://github.com/Swicv/note⁠