当前位置： 首页 > news >正文

开源一体化协作平台Colanode

news 2025/7/17 10:08:50

在这里插入图片描述

简介

什么是 Colanode ？

Colanode 是一个开源的、以本地为中心的协作工作空间，旨在提供一个替代 Slack 和 Notion 的平台，让用户完全掌控自己的数据。它采用本地优先方法设计，可帮助团队在线或离线沟通、组织和管理项目。可以获得现代协作工具的灵活性，以及拥有数据带来的安心。

主要特点

  1. 实时聊天：提供即时消息功能，方便团队沟通。
  2. 丰富文本页面：支持文档、维基和笔记的创建，类似于 Notion 的编辑器。
  3. 可定制数据库：允许组织信息，使用自定义字段和动态视图（如表格、看板、日历）。
  4. 文件管理：在安全的工作空间内轻松存储、共享和管理文件。
  5. 本地优先工作流：所有更改首先保存到本地 SQLite 数据库，然后同步到服务器，即使在离线状态下也能继续工作。
  6. 并发编辑：使用 CRDT 技术支持实时协作，允许多人同时编辑同一条目。

应用场景

  • 团队协作：适合团队管理项目、进行沟通和共享文件。
  • 个人工作空间：为个人用户提供一个私密的笔记和任务管理工具。
  • 自托管解决方案：用户可以选择自托管 Colanode，完全掌控数据隐私。
  • 小型项目管理：适合小型项目或初创公司快速搭建协作平台。

准备

如果像往常一样采用 http://群晖IP:4330 访问网页端，会显示下面这样的页面

因为 Colanode 使用了 Origin Private File System (OPFS) 存储方案。就是浏览器给每个网站提供的一个私有的、高性能的本地磁盘空间。你可以把它想象成一个内置在浏览器里的、每个网站专属的“虚拟硬盘”。网站可以在这个“硬盘”里存取文件，速度很快，而且不会被其他网站或用户直接访问到，非常安全。

但为了安全起见，Origin Private File System (OPFS) 以及其所属的 File System API 通常要求页面在安全的上下文 (Secure Context) 中运行，这基本上意味着必须使用 HTTPS 协议。

反向代理

准备好两个子域名。

域名局域网地址备注
css.laosu.techhttp://192.168.0.197:4331colanode_server 的访问地址
csc.laosu.techhttp://192.168.0.197:4330colanode_web 的访问地址

没有什么特殊设置，所以就不放图了

安装

在群晖上以 Docker 方式安装。

本文写作时， ghcr.io/colanode/server:latest 版本对应为 0.2.5；

ghcr.io/colanode/web:latest 版本对应为 0.2.5；

采用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3.8'services:postgres:image: pgvector/pgvector:pg17container_name: colanode_postgresrestart: alwaysenvironment:POSTGRES_USER: colanode_userPOSTGRES_PASSWORD: postgrespass123POSTGRES_DB: colanode_dbvolumes:- ./postgres_data:/var/lib/postgresql/data# ports:#  - '5432:5432'valkey:image: valkey/valkey:8.1container_name: colanode_valkeyrestart: alwayscommand: ['valkey-server', '--requirepass', 'your_valkey_password']volumes:- ./valkey_data:/data# ports:#   - '6379:6379'minio:image: minio/minio:RELEASE.2025-04-08T15-41-24Zcontainer_name: colanode_miniorestart: alwaysenvironment:MINIO_ROOT_USER: minioadminMINIO_ROOT_PASSWORD: your_minio_passwordMINIO_BROWSER: 'on'MINIO_DOMAIN: minioMINIO_ADDRESS: ':9000'MINIO_CONSOLE_ADDRESS: ':9001'volumes:- ./minio_data:/data# ports:#   - '9000:9000'#   - '9001:9001'entrypoint: shcommand: -c 'mkdir -p /data/colanode-avatars /data/colanode-files && minio server /data --address ":9000" --console-address ":9001"'# ---------------------------------------------------------------# Optional SMTP Server (Mailpit) for Local Email Testing# ---------------------------------------------------------------# This service runs Mailpit, a local SMTP testing tool.# If you want to test how emails are sent in the 'server' service,# you can uncomment the 'smtp' service block and configure the# SMTP_ENABLED variable to 'true' in the 'server' service environment# variables.## Access the Mailpit UI at http://localhost:8025# ---------------------------------------------------------------# smtp:#  image: axllent/mailpit:v1.24.1#  container_name: colanode_smtp#  restart: always#  ports:#    - '1025:1025' # SMTP IN (Connect server service to this port)#    - '8025:8025' # Web UI#  networks:#    - colanode_networkserver:image: ghcr.io/colanode/server:latestcontainer_name: colanode_serverrestart: alwaysdepends_on:- postgres- valkey- minio# - smtp # Optionalenvironment:# ───────────────────────────────────────────────────────────────# General Node/Server Config# ───────────────────────────────────────────────────────────────NODE_ENV: production# The server requires a name and avatar URL which will be displayed in the desktop app login screen.SERVER_NAME: 'Colanode Local'SERVER_AVATAR: ''# Possible values for SERVER_MODE: 'standalone', 'cluster'SERVER_MODE: 'standalone'# Optional custom path prefix for the server.# Add a plain text without any slashes. For example if you set 'colanode'# the URL 'https://localhost:3000/config' will be: 'https://localhost:3000/colanode/config'# SERVER_PATH_PREFIX: 'colanode'# Optional CORS Configuration. By default the server is accessible from 'http://localhost:4000'.# You can change this to allow custom origins (use comma to separate multiple origins) or '*' to allow all origins.SERVER_CORS_ORIGIN: 'https://csc.laosu.tech'SERVER_CORS_MAX_AGE: '7200'# ───────────────────────────────────────────────────────────────# Account Configuration# ───────────────────────────────────────────────────────────────# Possible values for ACCOUNT_VERIFICATION_TYPE: 'automatic', 'manual', 'email'ACCOUNT_VERIFICATION_TYPE: 'automatic'ACCOUNT_OTP_TIMEOUT: '600' # in seconds# If you want to enable Google login, you need to set the following variables:# ACCOUNT_GOOGLE_ENABLED: 'true'# ACCOUNT_GOOGLE_CLIENT_ID: 'your_google_client_id'# ACCOUNT_GOOGLE_CLIENT_SECRET: 'your_google_client_secret'# ───────────────────────────────────────────────────────────────# User Configuration# ───────────────────────────────────────────────────────────────USER_STORAGE_LIMIT: '10737418240' # 10 GBUSER_MAX_FILE_SIZE: '104857600' # 100 MB# ───────────────────────────────────────────────────────────────# PostgreSQL Configuration# ───────────────────────────────────────────────────────────────# The server expects a PostgreSQL database with the pgvector extension installed.POSTGRES_URL: 'postgres://colanode_user:postgrespass123@postgres:5432/colanode_db'# Optional variables for SSL connection to the database# POSTGRES_SSL_REJECT_UNAUTHORIZED: 'false'# POSTGRES_SSL_CA: ''# POSTGRES_SSL_KEY: ''# POSTGRES_SSL_CERT: ''# ───────────────────────────────────────────────────────────────# Redis Configuration# ───────────────────────────────────────────────────────────────REDIS_URL: 'redis://:your_valkey_password@valkey:6379/0'REDIS_DB: '0'# Optional variables:REDIS_JOBS_QUEUE_NAME: 'jobs'REDIS_JOBS_QUEUE_PREFIX: 'colanode'REDIS_EVENTS_CHANNEL: 'events'# ───────────────────────────────────────────────────────────────# S3 configuration for files.# In the future we will support other storage providers.# ───────────────────────────────────────────────────────────────STORAGE_S3_ENDPOINT: 'http://minio:9000'STORAGE_S3_ACCESS_KEY: 'minioadmin'STORAGE_S3_SECRET_KEY: 'your_minio_password'STORAGE_S3_BUCKET: 'colanode'STORAGE_S3_REGION: 'us-east-1'STORAGE_S3_FORCE_PATH_STYLE: 'true'# ───────────────────────────────────────────────────────────────# SMTP configuration# ---------------------------------------------------------------# We leave the SMTP configuration disabled by default.# ---------------------------------------------------------------SMTP_ENABLED: 'false'# ---------------------------------------------------------------# If using the local Mailpit service (defined above), use:# SMTP_ENABLED: 'true'# SMTP_HOST: 'smtp'# SMTP_PORT: '1025'# SMTP_USER: ''# SMTP_PASSWORD: ''# SMTP_EMAIL_FROM: 'your_email@example.com'# SMTP_EMAIL_FROM_NAME: 'Colanode'# ---------------------------------------------------------------# If using a real SMTP provider, update these:# SMTP_ENABLED: 'true'# SMTP_HOST: 'your_smtp_provider_host'# SMTP_PORT: '587' # Or 465, etc.# SMTP_USER: 'your_smtp_username'# SMTP_PASSWORD: 'your_smtp_password'# SMTP_EMAIL_FROM: 'your_email@example.com'# SMTP_EMAIL_FROM_NAME: 'Colanode'# ---------------------------------------------------------------# ───────────────────────────────────────────────────────────────# AI Configuration# ---------------------------------------------------------------# The AI integration is in experimental mode yet and we don't# recommend using it.# ---------------------------------------------------------------AI_ENABLED: 'false'# ───────────────────────────────────────────────────────────────ports:- '4331:3000'web:image: ghcr.io/colanode/web:latestcontainer_name: colanode_webrestart: alwaysports:- '4330:80'

关于各容器环境变量的简单说明

  • Postgres 容器环境变量
环境变量描述
POSTGRES_USERPostgreSQL 数据库的用户名，默认为 colanode_user。
POSTGRES_PASSWORDPostgreSQL 数据库用户的密码，默认为 postgrespass123。
POSTGRES_DB默认创建的数据库名称，默认为 colanode_db。
  • Valkey 容器环境变量
环境变量描述
--requirepassValkey 服务器的访问密码，需自定义，如 your_valkey_password。
  • Minio 容器环境变量
环境变量描述
MINIO_ROOT_USERMinio 管理员的用户名，默认为 minioadmin。
MINIO_ROOT_PASSWORDMinio 管理员的密码，需自定义，如 your_minio_password。
MINIO_BROWSER启用 Minio 浏览器界面，设为 'on'。
MINIO_DOMAINMinio 的域名，默认为 minio。
MINIO_ADDRESSMinio 监听的地址和端口，默认为 ':9000'。
MINIO_CONSOLE_ADDRESSMinio 控制台监听的地址和端口，默认为 ':9001'。
  • Server 容器环境变量
环境变量描述
NODE_ENV设置运行环境，通常为 production。
SERVER_NAME服务器名称，显示在桌面应用的登录界面，如 'Colanode Local'。
SERVER_AVATAR服务器的头像 URL，默认为空。
SERVER_MODE服务器模式，可能值为 'standalone' 或 'cluster'。
SERVER_CORS_ORIGIN允许的 CORS 来源，使用逗号分隔多个来源）或使用“*”以允许所有来源。
SERVER_CORS_MAX_AGECORS 预检请求的有效期，单位为秒，默认为 '7200'。
ACCOUNT_VERIFICATION_TYPE账户验证类型，可能值为 'automatic'、'manual' 或 'email'。
ACCOUNT_OTP_TIMEOUTOTP 超时时间，单位为秒，默认为 '600'。
USER_STORAGE_LIMIT用户存储限制，默认为 10 GB（10737418240 字节）。
USER_MAX_FILE_SIZE用户最大文件大小，默认为 100 MB（104857600 字节）。
POSTGRES_URLPostgreSQL 数据库连接字符串，格式为 postgres://<user>:<password>@<host>:<port>/<dbname>。
REDIS_URLRedis 连接字符串，格式为 redis://<password>@<host>:<port>/0。
REDIS_DBRedis 数据库，默认为 '0'。
STORAGE_S3_ENDPOINTS3 兼容存储的端点 URL，默认为 http://minio:9000。
STORAGE_S3_ACCESS_KEYS3 访问密钥，默认为 minioadmin。
STORAGE_S3_SECRET_KEYS3 秘密访问密钥，需自定义，如 your_minio_password。
STORAGE_S3_BUCKETS3 存储桶名称，默认为 colanode。
STORAGE_S3_REGIONS3 存储区域，默认为 us-east-1。
STORAGE_S3_FORCE_PATH_STYLE强制使用路径样式，默认为 'true'。
SMTP_ENABLED启用 SMTP 配置，默认为 'false'。
AI_ENABLED启用 AI 集成，默认为 'false'。

然后执行下面的命令

# 新建文件夹 colanode 和 子目录
mkdir -p /volume1/docker/colanode/{minio_data,postgres_data,valkey_data}# 进入 colanode 目录
cd /volume1/docker/colanode# 将 docker-compose.yml 放入当前目录# 一键启动
docker-compose up -d

运行

在浏览器中输入服务端地址： https://css.laosu.tech，复制下来，一会儿客户端设置会用到

在浏览器中输入客户端地址： https://csc.laosu.tech

点 Add new server

填入服务器地址，点 Create

添加完成后，下拉列表中会多出一个 Colanode Local

选择我们自己的服务器后，就可以注册账号了

注册成功后的主界面

接下来就可以建 space、page 、channel 等

除了网页版之外还支持多个操作系统的桌面客户端

使用比较简单，可以看看官方的动图

参考文档

colanode/colanode: Open-source and local-first Slack and Notion alternative that puts you in control of your data
地址：https://github.com/colanode/colanode

Colanode - Open-source & local-first Slack and Notion alternative
地址：https://colanode.com/

http://www.lryc.cn/news/590315.html

相关文章：

  • uniapp小程序实现地图多个标记点
  • 数据结构与算法学习（一）
  • Java大厂面试实录：从Spring Boot到AI微服务架构的全栈挑战
  • PyCharm高效入门指南大纲
  • 图机器学习（8）——经典监督图嵌入算法
  • 浅析BLE/MQTT协议的区别
  • Web3.0与元宇宙：重构数字文明的技术范式与社会变革
  • 创客匠人解析：系统化工具如何重构知识变现效率
  • AI Agent：重构智能边界的终极形态——从技术内核到未来图景全景解析
  • UDP和TCP的主要区别是什么？
  • 智能呼叫中心系统：重构客户服务的核心引擎
  • 【保姆级喂饭教程】Idea中配置类注释模板
  • C++---emplace_back与push_back
  • Java接口：小白如何初步认识Java接口？
  • C语言 个人总结1
  • 【SF顺丰】顺丰开放平台API对接（Java对接篇）
  • AI Agent开发学习系列 - langchain之LCEL(2)：LCEL 链式表达解析
  • Nand2Tetris（计算机系统要素）学习笔记 Project 0
  • 单片机学习笔记.IIC通信协议（根据数据手册写IIC驱动程序，这里以普中开发板上的AT24C02为例）
  • 【深度学习基础】PyTorch中model.eval()与with torch.no_grad()以及detach的区别与联系？
  • 嵌入式学习-PyTorch（5）-day22
  • 人工智能时代下的数据新职业：新兴工作岗位版图研究
  • 智能体架构深度解构：一次用户请求的完整旅程
  • 第二十一 篇 PDF文档自动化：Python一键合并、分割、水印、提取与加密解密！你的PDF全能管家！
  • audiorecord 之 抢占优先级
  • rLLM：用于LLM Agent RL后训练的创新框架
  • ESP32 S3 基于 Arduino 实现局域网视频流传输全解析
  • Python从入门到高手9.2节-Python字典的操作方法
  • 多维动态规划题解——不同路径【LeetCode】记忆化搜索
  • NumPy 常用操作详解汇总和实战示例