first commit

2024-03-12 00:26:54 -04:00
commit 3d476f095c
222 changed files with 26485 additions and 0 deletions
--- a/content/zh-cn/posts/docker-compose/excalidraw/excalidrawLocalDemo.webp
+++ b/content/zh-cn/posts/docker-compose/excalidraw/excalidrawLocalDemo.webp
--- a/content/zh-cn/posts/docker-compose/excalidraw/index.md
+++ b/content/zh-cn/posts/docker-compose/excalidraw/index.md
@@ -0,0 +1,199 @@
+---
+slug: "excalidraw-full-stack-docker"
+title: "Excalidraw 全栈自部署教程"
+subtitle: ""
+date: 2023-01-13T15:54:36+08:00
+lastmod: 2024-03-11T12:39:36-05:00
+draft: false
+author:
+  name: James
+  link: https://www.jamesflare.com
+  email:
+  avatar: /site-logo.avif
+description: 本文为你提供了一份使用 Docker Compose 部署完整 Excalidraw 技术栈的详细指南，包括前端界面、数据存储后端以及协作组件，让你能够快速搭建一个功能完备、支持分享和多人协作的 Excalidraw 私有部署。
+license: ""
+comment: true
+weight: 0
+
+tags:
+- Excalidraw
+- 开源软件
+- Docker
+categories:
+- 教程
+- 资源分享
+
+hiddenFromHomePage: false
+hiddenFromSearch: false
+
+summary: 通过本文，你将学会使用 Docker Compose 一键部署拥有前端界面、数据存储和多人协作等全部功能的 Excalidraw 技术栈，快速搭建一个可以私有使用、分享协作的 Excalidraw 部署。
+resources:
+- name: featured-image
+  src: featured-image.jpg
+- name: featured-image-preview
+  src: featured-image-preview.jpg
+
+toc:
+  enable: true
+math:
+  enable: false
+lightgallery: true
+seo:
+  images: []
+
+repost:
+  enable: true
+  url: ""
+
+# 查看 Front Matter 的详细配置说明：https://fixit.lruihao.cn/theme-documentation-content/#front-matter
+---
+
+## Intro
+
+这可能是中文互联网上唯一一篇讲如何全栈部署 Excalidraw 的，绝大多数只是部署了一个残血的前端。
+
+本人试图在本地私有化部署 Excalidraw，操作是很简单，根据官方的 README，一会就完成了是吧。
+
+### Issue
+
+但是有没有发现，分享链接和在线协作有问题，用不了？甚至 Libraries 还有点问题？
+
+这是因为，几乎全网的搭建教程都只是搭建了 excalidraw-app 这个前端，它的存储需要 excalidraw-json，协作需要 excalidraw-room。
+
+这些代码官方都开源了，不过前端的进度实在是太快了，于是乎这些就都用不了了。
+
+比如官方开放的 excalidraw-json 是 S3 的存储，现在不出意外是 firebase，官方也没出个剥离的版本，那我们怎么办呢？
+
+### Solution
+
+答，**降级**，**构建全栈**。
+
+excalidraw-app 我们用官方的，不过版本差不多是 9 个月前的，讲道理，功能也没少多少，bug 也没什么问题，这一代前端可以很好兼容。
+
+excalidraw-json 是用不得了，国外也有一些方案用 minio 来跑 S3 对接它，但是我测试了，问题有些大，这个后端应该是用不得了，所幸的是，我找到了一个第三方，用自己代码实现的全功能后端，支持 v2 的 api，excalidraw-storage-backend。
+
+excalidraw-room 我们用官方的，最新一版，差不多是 9 个月前的，和前端一致，可以正常使用。
+
+redis，这个是 excalidraw-storage-backend 所需要的，用于临时存储分享画板的数据，所以它不能保证数据可靠性。
+
+那我们开始吧，本方案使用 docker-compose。
+
+- excalidraw-app
+- excalidraw-room
+- excalidraw-storage-backend
+- redis
+
+## Docker Compose
+
+Docker Compose 配置
+
+```yaml
+version: "3.8"
+
+services:
+  excalidraw:
+    image: kiliandeca/excalidraw
+    healthcheck:
+      disable: true
+    ports:
+      - "80:80" # 默认端口80，可以修改
+    environment:
+      BACKEND_V2_GET_URL: http://localhost:8080/api/v2/scenes/
+      BACKEND_V2_POST_URL: http://localhost:8080/api/v2/scenes/
+      LIBRARY_URL: https://libraries.excalidraw.com
+      LIBRARY_BACKEND: https://us-central1-excalidraw-room-persistence.cloudfunctions.net/libraries
+      SOCKET_SERVER_URL: http://localhost:5000/
+      STORAGE_BACKEND: "http"
+      HTTP_STORAGE_BACKEND_URL: "http://localhost:8080/api/v2"
+
+  excalidraw-storage-backend:
+    image: kiliandeca/excalidraw-storage-backend
+    ports:
+      - "8080:8080"
+    environment:
+      STORAGE_URI: redis://redis:6379
+
+  excalidraw-room:
+    image: excalidraw/excalidraw-room
+    ports:
+      - "5000:80"
+
+  redis:
+    image: redis
+    ports:
+      - "6379:6379"
+```
+
+本身不支持 https，如有需要可以通过反向代理实现，不过记得同时修改 environment 中的变量
+
+此配置文件经本地测试通过，可完美运行。
+
+{{< image src="excalidrawLocalDemo.webp" >}}
+
+---
+
+如果你 6379 端口有冲突，那可以选择构建一个 network
+
+```bash
+docker network create excalidraw-net
+```
+
+然后像这样对其进行一些修改，就完成了
+
+```yaml
+version: "3.8"
+
+services:
+  excalidraw:
+    image: kiliandeca/excalidraw
+    healthcheck:
+      disable: true
+    ports:
+      - "80:80"
+    environment:
+      BACKEND_V2_GET_URL: http://localhost:8080/api/v2/scenes/
+      BACKEND_V2_POST_URL: http://localhost:8080/api/v2/scenes/
+      LIBRARY_URL: https://libraries.excalidraw.com
+      LIBRARY_BACKEND: https://us-central1-excalidraw-room-persistence.cloudfunctions.net/libraries
+      SOCKET_SERVER_URL: http://localhost:5000/
+      STORAGE_BACKEND: "http"
+      HTTP_STORAGE_BACKEND_URL: "http://localhost:8080/api/v2"
+
+  excalidraw-storage-backend:
+    image: kiliandeca/excalidraw-storage-backend
+    ports:
+      - "8080:8080"
+    environment:
+      STORAGE_URI: redis://redis:6379
+
+  excalidraw-room:
+    image: excalidraw/excalidraw-room
+    ports:
+      - "5000:80"
+
+  redis:
+    image: redis
+    expose:
+      - "6379"
+
+networks:
+  default:
+    external:
+      name: excalidraw-net
+```
+
+## Run
+
+找一个，或者新建一个目录，创建 docker-compose 文件。
+
+```bash
+nano docker-compose.yml
+```
+
+填入 docker-compose 配置，记得按你的实际情况修改。
+
+随后我们要配置一下反向代理，记得配置 WebSocket 支持，我这里就跳过了。
+
+思路是这样的，参考下面配置即可：
+
+{{< image src="stackDrawing.webp" caption="Stack" width="600px" >}}
--- a/content/zh-cn/posts/docker-compose/excalidraw/stackDrawing.webp
+++ b/content/zh-cn/posts/docker-compose/excalidraw/stackDrawing.webp
--- a/content/zh-cn/posts/docker-compose/umami-migration/index.md
+++ b/content/zh-cn/posts/docker-compose/umami-migration/index.md
@@ -0,0 +1,188 @@
+---
+title: 将 Umami Docker 从一台服务器迁移到另一台服务器
+subtitle:
+date: 2024-03-11T18:03:39-04:00
+slug: umami-docker-migration
+draft: false
+author:
+  name: James
+  link: https://www.jamesflare.com
+  email:
+  avatar: /site-logo.avif
+description: 本文将介绍如何通过导出和导入 PostgreSQL 数据库，将 Docker 上运行的 Umami 服务器从一台机器迁移到另一台机器，确保在保留所有关键数据的同时实现平稳过渡。
+license:
+comment: true
+weight: 0
+tags:
+- PostgreSQL
+- 开源
+- Docker
+- Umami
+categories:
+- 教程
+hiddenFromHomePage: false
+hiddenFromSearch: false
+hiddenFromRss: false
+hiddenFromRelated: false
+summary: 本文将介绍如何通过导出和导入 PostgreSQL 数据库，将 Docker 上运行的 Umami 服务器从一台机器迁移到另一台机器，确保在保留所有关键数据的同时实现平稳过渡。
+resources:
+  - name: featured-image
+    src: featured-image.jpg
+  - name: featured-image-preview
+    src: featured-image-preview.jpg
+toc: true
+math: false
+lightgallery: false
+password:
+message:
+repost:
+  enable: true
+  url:
+
+# 查看前言详细信息：https://fixit.lruihao.cn/documentation/content-management/introduction/#front-matter
+---
+
+<!--more-->
+
+## 简介
+
+最近我从 netcup GmbH 购买了一台新的 ARM 服务器，需要把 Umami 服务器从旧服务器迁移到新服务器上。但我是用 Docker 安装的 Umami。
+
+```yaml
+version: '3'
+services:
+  umami:
+    image: ghcr.io/umami-software/umami:postgresql-latest
+    ports:
+      - "3000:3000"
+    environment:
+      DATABASE_URL: postgresql://umami:umami@db:5432/umami
+      DATABASE_TYPE: postgresql
+      APP_SECRET: replace-me-with-a-random-string
+    depends_on:
+      db:
+        condition: service_healthy
+    restart: always
+  db:
+    image: postgres:15-alpine
+    environment:
+      POSTGRES_DB: umami
+      POSTGRES_USER: umami
+      POSTGRES_PASSWORD: umami
+    volumes:
+      - umami-db-data:/var/lib/postgresql/data
+    restart: always
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+volumes:
+  umami-db-data:
+```
+
+迁移中最困难和重要的部分就是导出 Umami 的数据。我们有几种方法可以实现：
+
+- 导出 Docker 卷（非常复杂）
+- 导出数据库（我的选择）
+- 复制整个路径（不推荐）
+
+## 比较方法
+
+首先，我们要知道 Umami 的数据是存储在卷（Volume）中的。因为 `docker-compose.yml` 指定了：
+
+```yaml
+services:
+  db:
+    volumes:
+      - umami-db-data:/var/lib/postgresql/data
+volumes:
+  umami-db-data:
+```
+
+如果我把路径挂载到容器里而不是卷，那就可以直接把路径复制到新机器上。比如：
+
+```yaml
+services:
+  db:
+    volumes:
+      - /root/umami/data:/var/lib/postgresql/data
+```
+
+可惜我用了卷，导致事情变得复杂。如何正确迁移 Docker 卷在网上有很多讨论，比如 [将 Docker 卷移动到另一台主机](https://4sysops.com/archives/move-a-docker-volume-to-another-host/)。但对我来说太复杂了。你可能会问，Docker 卷不是存储在固定路径如 `/var/lib/docker/volumes/*` 吗？为什么不直接把文件夹复制到另一台机器并正常启动呢？这确实可行，我以前也这么干过。但它可能会导致一些潜在问题，尤其是对于不同的 Docker 容器版本。
+
+最后，我决定只导出数据库并导入到新实例中。让我们一步一步来。
+
+## 迁移数据库
+
+首先，让我们进入旧容器的 Shell。
+
+```bash
+docker exec -it umami-db-1 /bin/sh
+```
+
+将数据库导出为 `.sql` 文件。
+
+```bash
+cd /
+pg_dump --username=umami umami > umami.sql
+```
+
+现在数据库备份在 `umami.sql` 文件中，但它在容器内部。按 `Ctrl + D` 退出容器 Shell，然后把文件复制到宿主机。
+
+```bash
+docker cp umami-db-1:/umami.sql /root
+```
+
+接着，你需要把这个备份文件传输到新主机上。在新主机上 `docker compose up -d` 后，`umami-db-1` 容器就会被创建。然后你可以通过以下命令把数据库备份文件复制到容器中：
+
+```bash
+docker cp /root/umami.sql umami-db-1:/
+```
+
+进入新的 `umami-db-1` 容器：
+
+```bash
+docker exec -it umami-db-1 /bin/sh
+```
+
+要把备份导入 Postgres，我们需要以 `umami` 用户登录 `psql`：
+
+```bash
+psql --username=umami -d postgres
+```
+
+在 `psql` Shell 中，我们先删除原有数据库，再创建一个空白数据库以准备导入。
+
+```bash
+DROP DATABASE umami;
+CREATE DATABASE umami;
+```
+
+然后退出 `psql` Shell，运行以下命令导入备份文件：
+
+```bash
+cd /
+psql --username=umami -f umami.sql umami
+```
+
+最后，重启 Umami 实例：
+
+```bash
+cd /path/to/umami/docker-compose.yaml/
+docker compose down
+docker compose up -d
+```
+
+## 检查
+
+现在可以检查数据库是否迁移成功了。打开新 Umami 的 URL，尝试用原来的账号登录。如果能登录，那数据库很可能迁移成功了（账号信息是存在数据库里的）。
+
+为了进一步确认，你可以进入仪表盘，看看所有数据是否正常显示。
+
+如果不正常，说明数据库没有成功迁移。你可以检查导出的备份文件（里面是否包含正确的数据？），以及导入的方式（看看备份文件是否成功导入到新的 Postgres）。
+
+## 参考
+
+- [如何将 Umami 从一台服务器迁移到另一台服务器](https://www.programonaut.com/how-to-migrate-umami-from-one-server-to-another/)
+- [如何在 Linux 中备份和恢复 PostgreSQL 数据库](https://www.tecmint.com/backup-and-restore-postgresql-database/)