110 lines
4.1 KiB
Markdown
110 lines
4.1 KiB
Markdown
---
|
|
title: SiYuan
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, note-taking, siyuan, pkm, knowledge-base, block-editor, docker, privacy]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Note-Taking, https://github.com/siyuan-note/siyuan, https://b3log.org/siyuan]
|
|
---
|
|
|
|
# 🔗 SiYuan
|
|
|
|
> **Le PKM auto-hébergé orienté blocs et références bidirectionnelles**, pour celles et ceux qui veulent une base de connaissance personnelle dense, locale et très structurée.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [b3log.org/siyuan](https://b3log.org/siyuan) |
|
|
| **GitHub** | [siyuan-note/siyuan](https://github.com/siyuan-note/siyuan) |
|
|
| **Licence** | AGPL-3.0 |
|
|
| **Langage** | TypeScript, Go |
|
|
| **Étoiles GitHub** | 44.3k ⭐ |
|
|
| **Dernière MAJ** | 2026-04-21 |
|
|
| **Catégorie** | [[cat-note-taking|Note-Taking]] |
|
|
|
|
## 📝 Description
|
|
|
|
**SiYuan** est un outil de **personal knowledge management** centré sur les **blocs**, les **références fines** et les **liens bidirectionnels**. Le projet se décrit comme un logiciel de knowledge management **privacy-first** et auto-hébergeable, avec édition **Markdown WYSIWYG**.
|
|
|
|
Il s'adresse surtout aux utilisateurs qui veulent construire une **base de connaissance personnelle riche**, avec une granularité plus fine qu'un carnet de notes traditionnel. On est plus proche d'un **PKM moderne** que d'un simple éditeur de texte : blocs référençables, attributs, exports multiples, flashcards, annotations, snippets et API publique.
|
|
|
|
Points notables :
|
|
|
|
- ✅ Références au niveau bloc
|
|
- ✅ Liens bidirectionnels et édition Markdown WYSIWYG
|
|
- ✅ Déploiement Docker officiellement documenté
|
|
- ✅ API publique et nombreuses fonctions avancées
|
|
- ⚠️ Certaines fonctionnalités sont réservées aux membres payants
|
|
- ⚠️ Le projet déconseille l'usage de solutions de sync tierces non prévues, sous peine de corruption
|
|
|
|
## 🚀 Installation
|
|
|
|
### Option recommandée : Docker Compose
|
|
|
|
Le dépôt fournit un exemple Compose clair.
|
|
|
|
```yaml
|
|
services:
|
|
siyuan:
|
|
image: b3log/siyuan
|
|
container_name: siyuan
|
|
command: ['--workspace=/siyuan/workspace/', '--accessAuthCode=change-me']
|
|
ports:
|
|
- "6806:6806"
|
|
volumes:
|
|
- ./siyuan-workspace:/siyuan/workspace
|
|
restart: unless-stopped
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
- PUID=1000
|
|
- PGID=1000
|
|
```
|
|
|
|
## ⚙️ Configuration Initiale
|
|
|
|
1. **Créer un workspace persistant** sur le volume monté.
|
|
2. **Définir un `accessAuthCode` fort** avant exposition réseau.
|
|
3. **Ajuster PUID/PGID** pour éviter les problèmes de permissions.
|
|
4. **Tester les sauvegardes** du workspace avant un usage intensif.
|
|
5. **Éviter les solutions de synchronisation tierces** non recommandées par le projet.
|
|
6. **Décider si les fonctions avancées** comme OCR, API ou IA sont nécessaires.
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-trilium-notes]] — PKM hiérarchique avec arbre profond
|
|
- [[app-joplin]] — Plus classique et plus grand public
|
|
- [[app-affine]] — Plus collaboratif et plus visuel
|
|
- [[app-appflowy]] — Workspace plus large orienté équipes
|
|
- **Logseq** — PKM local-first proche en philosophie
|
|
|
|
### Propriétaires
|
|
- **Obsidian Sync + plugins**
|
|
- **Roam Research**
|
|
- **Notion**
|
|
- **Mem.ai**
|
|
|
|
## 🔐 Sécurité
|
|
|
|
- ✅ Le projet met en avant une approche **privacy-first**
|
|
- ✅ Le code d'accès de l'instance doit être défini dès le départ
|
|
- ⚠️ Une mauvaise stratégie de synchronisation peut corrompre les données
|
|
- ✅ Sauvegarder régulièrement le workspace et tester les restaurations
|
|
- ✅ Exposer l'instance derrière HTTPS si accessible à distance
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Site officiel](https://b3log.org/siyuan)
|
|
- [GitHub siyuan-note/siyuan](https://github.com/siyuan-note/siyuan)
|
|
- [Releases / documentation de déploiement via README](https://github.com/siyuan-note/siyuan)
|
|
|
|
## Pages Liées
|
|
|
|
- [[cat-note-taking]] — Catégorie Note-Taking
|
|
- [[app-trilium-notes]] — Autre outil PKM avancé
|
|
- [[app-joplin]] — Notes plus classiques
|
|
- [[app-affine]] — Workspace plus collaboratif
|