# Wiki相關

Wiki首頁、範本等等

# 首頁

歡迎來到美代子的Wiki，這裡用來記載[我的Minecraft伺服器](https://discord.gg/mSdMqEAAFW)相關的知識，也會用於記載一些跟我有關的事情。

可以置右上角書架查看相關內容。

<p class="callout warning">Wiki 的內容一直在變，相關章節也有可能從原書本移動到其他書本去  
建議善用畫面正上方的搜尋功能進行查找</p>

## Minecraft 伺服器

一些關於 Minecraft 伺服器的現今資訊

<table border="1" id="bkmrk-minecraft-%E7%89%88%E6%9C%AC-1.20.4-" style="border-collapse: collapse; width: 54.4048%; height: 119.2px;"><colgroup><col style="width: 24.9946%;"></col><col style="width: 75.0091%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">Minecraft 版本  
</td><td style="height: 29.8px;">1.21  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">伺服器API  
</td><td style="height: 29.8px;">Fabric Loader 0.15.11  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">模組包  
</td><td style="height: 29.8px;">Nesquate Server's Modpack 2.0.3  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">上次維護  
</td><td style="height: 29.8px;">2024/07/14  
</td></tr></tbody></table>

## 未完成的 Wiki 頁面

可以查看 [未完成 Wiki](https://wiki.nesquate.tw/search?term=%5B%E6%9C%AA%E5%AE%8C%E6%88%90+Wiki%3Dunfinished-wiki%5D) 標籤的搜尋結果。

## 所有標籤

可以參考[這個](https://wiki.nesquate.tw/books/wiki/page/2b24d "標籤列表 & 搜尋結果")頁面。

# BookStack 維護

# 在 BookStack 上使用 Cloudflare R2

### 問題概述

官方教學其實已經有說明，這裡補足目前 (2024/01/24) 官方教學略為不足的部分。

一樣是編輯 .env 檔案，並且加入以下內容：

```yaml
STORAGE_TYPE=s3
STORAGE_S3_KEY=<access_key>
STORAGE_S3_SECRET=<access_secret_key>
STORAGE_S3_REGION=auto
STORAGE_S3_BUCKET=<bucket_name>

STORAGE_S3_ENDPOINT=<endpoint_url>
STORAGE_URL=<url>
```

STORAGE\_S3\_KEY、STORAGE\_S3\_SECRET、STORAGE\_S3\_BUCKET 和 STORAGE\_S3\_ENDPOINT 基本上跟官方教學差不多。

需要增加的是 STORAGE\_S3\_REGION ，而且必須是 auto ，否則 Log 會噴 400 Bad Request 的錯誤。

這個資訊我還是在官方 Git repository 的 Issues 上才發現的。不過我以為 BookStack 預設應該會是 auto，原來不是嗎......。

### 參考

- [Configuring File Uploads · BookStack](https://www.bookstackapp.com/docs/admin/upload-config/)
- [Minio Implementation for Amazon S3 · Issue #1195 · BookStackApp/BookStack](https://github.com/BookStackApp/BookStack/issues/1195)

# 升級 BookStack

記錄一下自己怎麼更新 BookStack。[官方有相關教學](https://www.bookstackapp.com/docs/admin/updates/)，直接照做就好，唯一的不同是所有指令必須以 Web Server 使用者執行，以免權限不足。例如 [Caddy server](https://caddyserver.com/) 必須要用 `sudo` 以 `caddy` 的使用者身份執行。

#### 抓取最新原始碼

用 Git 抓就好了，一般來說在裝 BookStack 的時候是整個 Git repository 一起抓下來。

```shell
sudo -u caddy git pull origin release
```

#### 使用 `composer` 重新安裝心版本 BookStack 的依賴

記得加上 `--no-dev`，否則可能會安裝到開發用環境。

```shell
sudo -u caddy composer install --no-dev
```

#### 合併資料庫

每次升級資料庫可能都會有變動，執行一下以免 BookStack 出錯。

```shell
sudo -u caddy php artisan migrate
```

#### 檢查 BookStack 是否有問題

全部操作一遍之後，如果沒有任何報錯，可以先去 Wiki 首頁看看有沒有問題。

如果有問題的話就需要去看 Debug 記錄，沒有的話基本上是大功告成。

#### 可做可不做：清理相關快取

把設定、頁面等快取進行清理，可以避免某些因快取而生的奇怪問題。

```shell
sudo -u caddy php artisan cache:clear
sudo -u caddy php artisan config:clear
sudo -u caddy php artisan view:clear
```

# 標籤列表 & 搜尋結果

## 頁面本身狀態

- [未完成 Wiki](https://wiki.nesquate.tw/search?term=%5B%E6%9C%AA%E5%AE%8C%E6%88%90+Wiki%3Dunfinished-wiki%5D)

## 寫程式相關

- [Java 概念](https://wiki.nesquate.tw/search?term=%5BJava+%E6%A6%82%E5%BF%B5%3Djava-concept%5D)

## 刷題相關

- [刷題狀態](https://wiki.nesquate.tw/search?term=%5B%E5%88%B7%E9%A1%8C%E7%8B%80%E6%85%8B%5D) ，後面可以加等號，可以填入以下內容 
    - 需要再複習
    - 已完成