PassNAT LogoPassNAT

我注意到您发送的内容中,前半部分是关于SEO标题生成的指示,后半部分是关于Cogito项目的部署教程。 根据您最初的指示,我应该为这个Cogito项目生成一个50-60个中文字的SEO标题。 以下是生成的标题: Cogito个人知识库系统自建指南,NAS极简部署智能笔记管理工具,支持内网穿透远程访问

作者

小编

发布时间

Curving abstract shapes with an orange and blue gradient

项目介绍

Cogito 是一款功能强大的个人知识管理系统,将你的笔记、链接、推文和各类信息汇聚一处。它采用 Angular + Spring Boot 技术栈开发,提供了一个直观易用的界面来管理和组织你的数字资产。

无论是保存有趣的网页链接、记录重要推文,还是撰写个人笔记,Cogito 都能帮你轻松整理。项目支持智能标签自动分类、全文搜索、深色主题、待办事项标记等丰富功能。此外,它还提供了 PWA 应用支持,让你在手机上也能方便地分享内容到 Cogito。

界面简洁美观,部署简单快速,特别适合想要搭建个人知识库的用户。

项目地址:点我跳转


部署安装

如需在外网访问你的 Cogito 实例,建议配置内网穿透服务。可以前往 帕斯内网穿透

注册账号。具体的操作流程可以参考 这份详细的上手指南

,支持全平台快速配置。

使用 Docker Compose 快速部署

第一步:准备配置文件

创建一个名为 'cogito' 的文件夹,并在其中新建 'docker-compose.yml' 文件。

第二步:复制配置内容

将下列配置复制到 'docker-compose.yml' 文件中:

1version: "3"
2
3services:
4 cogito:
5 image: tukks/cogito:latest
6 ports:
7 - "8585:9191"
8 volumes:
9 - ./db:/app/db
10 - ./image:/app/image
11 environment:
12 - APP_JWT_SECRET="YOUR_APP_GENERATE_SECRET"
13 - API_TWITTER_KEY_SECRET="YOUR_API_TWITTER_KEY_SECRET"
14 - API_TWITTER_KEY="YOUR_API_TWITTER_KEY"
15 - HTTPS_ONLY=true

如果你使用树莓派或其他 ARM 架构设备,请将镜像改为 'tukks/cogito-armv7:latest'

第三步:配置环境变量

打开飞牛 NAS、群晖或其他 NAS 设备的管理界面,找到 Docker 容器管理功能。

环境变量设置说明:

必须设置:

'APP_JWT_SECRET':应用的 JWT 密钥,建议使用 Bitwarden 等工具生成一个 256 位(128 字符长)的随机字符串。这是保证应用安全的关键参数。

可选设置:

'API_TWITTER_KEY':Twitter 开发者账号的 API Key(如需集成推文保存功能)

'API_TWITTER_KEY_SECRET':Twitter 开发者账号的 API Secret(如需集成推文保存功能)

'HTTPS_ONLY':是否仅允许 HTTPS 连接,默认为 true。如果在测试环境可设为 false

其他参数保持默认即可,无需修改。

第四步:启动容器

在 NAS 的 SSH 终端或 Docker 管理界面中,进入 cogito 文件夹,执行以下命令:

1docker-compose up -d

等待容器启动完成。

第五步:初始化账户

打开浏览器,访问 'http://你的NAS_IP:8585'

首次访问时,点击'新建账户'按钮,输入邮箱和密码完成注册。然后使用刚才创建的邮箱和密码登录即可。

第六步:配置书签小工具(可选)

为了在浏览器中快速保存链接到 Cogito,可以添加一个书签小工具。在浏览器书签栏中新建书签,将下列代码添加到 URL 字段:

1javascript:(function(){window.open('https://你的Cogito地址/handle-share?text='+encodeURIComponent(window.location.href));}())

将 '你的Cogito地址' 替换为实际的访问地址。点击这个书签就能一键保存当前网页到 Cogito。


端口说明:

容器内部运行在 9191 端口,外部通过 8585 端口访问。如果 8585 端口被占用,可在 docker-compose.yml 中修改第一个端口号(如改为 '8686:9191'),但容器内部的 9191 端口保持不变。

存储说明:

'./db' 目录:存储应用数据库文件,请确保此目录有足够的空间

'./image' 目录:存储保存的图片和截图文件


至此,Cogito 部署完成!你现在可以开始使用这个强大的个人知识管理系统了。