# FAQ System FAQ

## 注意事項

- 本網站為安全起見只能使用[有支援 TLS 1.3 的瀏覽器](https://en.wikipedia.org/wiki/Transport_Layer_Security#Web_browsers)開啟
- 第一次啟動因為要確保連線安全所以製作 dhparam 憑證需要30分鐘左右
- 電腦開機登入之後 要等一陣子系統才會上線 可能5分鐘之類的
- 系統啟用 因為資料庫初始化 要花 15~20分鐘(系統在關機的時候只是暫停 不是關掉 所以不用等這麼久)

## 安裝前置作業

1. 打開`應用程式與功能` 

2. 選擇`相關設定`底下的`程式和功能` 

3. 選擇`開啟或關閉Windows功能` 

4. 勾選 `Hyper-V` 後按`確定`, 電腦會下載相關檔案並重新開機 

## 安裝與設定 Docker

1. [下載 Docker](https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe) 並安裝

2. 裝完之後工具列會有一隻鯨魚, 對他按右鍵選擇`Settings` 

3. General 底下勾選`Start Docker Desktop when you log in`和`Automatically check for updates` 

## 系統設定檔

1. 下載[start_mariadb.yml](https://raw.githubusercontent.com/Superdanby/faq-django-database-gunicorn-nginx-docker/master/start_mariadb.yml) 按右鍵另存新檔 

2. 存檔類型選擇所有檔案、檔名去掉尾端的`.txt`

3. 編輯 `start_mariadb.yml` 因為編碼關係, 回到[剛剛下載的網址](https://raw.githubusercontent.com/Superdanby/faq-django-database-gunicorn-nginx-docker/master/start_mariadb.yml) 選取所有內容再貼到`start_mariadb.yml`裡面, 並將 `mysqld --character-set-server=utf8 --collation-server=utf8_unicode_ci` 改成 `mysqld --innodb-flush-method=fsync --character-set-server=utf8 --collation-server=utf8_unicode_ci`

4. 下載[.env](https://raw.githubusercontent.com/Superdanby/faq-django-database-gunicorn-nginx-docker/master/.env.example) 存檔類型選擇所有檔案、檔名改成`.env`, 並跟`start_mariadb.yml`放在同一個資料夾

5. 編輯 `.env` 因為編碼關係, 回到[剛剛下載的網址](https://raw.githubusercontent.com/Superdanby/faq-django-database-gunicorn-nginx-docker/master/.env.example) 選取所有內容再貼到`.env`裡面, 必須修改的內容如下:

| 變數 | 說明 | 舉例 |
| ----------------------- | -------------------------- | -------------------------------------------------------------- |
| `SECRET_KEY` | 用來確保系統安全的隨機亂數 | `SECRET_KEY=opaeriseoprity98o@#*()^98023pIOH7I` |
| `DJANGO_ALLOWED_HOSTS` | 在後面加上server的IP | `DJANGO_ALLOWED_HOSTS=localhost 127.0.0.1 [::1] 172.29.147.15` |
| `DJANGO_SUPER_USER` | 網站超級使用者帳號 | `DJANGO_SUPER_USER=yeet` |
| `DJANGO_SUPER_PASSWORD` | 網站超級使用者密碼 | `DJANGO_SUPER_PASSWORD=yeet` |
| `DJANGO_SUPER_EMAIL` | 網站超級使用者Email | `DJANGO_SUPER_EMAIL=[e-mail]` |
| `MYSQL_ROOT_PASSWORD` | 資料庫系統最高權限密碼 | `MYSQL_ROOT_PASSWORD=yaaaaaaaaaaaaa!` |

## 網路設定

1. 打開`防火牆與網路保護` 

2. 選擇`進階設定`

3. 點擊`輸入規則` 

4. 在視窗右邊選擇`新增規則` 

5. 選擇`連接埠`按下一步 

6. 選擇`TCP`, 在`特定本機連接埠`內輸入`80`按下一步 

7. 選擇`允許連線`按下一步 

8. 指勾選`網域`按下一步 

9. 輸入名稱後按完成

## 啟用/關閉/更新系統

1. 在檔案系統位址列按一下 複製位址 

2. 打開 `PowerShell` 

3. 打 `cd` 然後貼上剛剛複製的位址 按 Enter 

4.
- 啟用: `docker-compose -f .\start_mariadb.yml up -d`
- 關閉: `docker-compose -f .\start_mariadb.yml down`
- 更新(必須先關閉, 更新後要啟用): `docker-compose -f .\start_mariadb.yml build --no-cache`

**更新如果失敗[請看故障排除](#故障排除)**

## 如何每個星期備份一次

1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. `robocopy G:\faq_server\ M:\faq_backup\ /MIR /FFT /R:3 /W:10 /Z /NP /NDL` 

9. 

10. 

## 匯入網站憑證

由於網站憑證是自己生產的而不是由外面公認單位產生因此連線的時候會出現網站憑證不安全的警告, 以下步驟即可將憑證匯入用戶端系統的信任列表

1. 連線後出現警告畫面 

2. 在瀏覽器設定中選擇管理憑證 

3. 啟動憑證小精靈後選擇受信任的跟憑證授權單位再選擇匯入 

4. 憑證放在 `M:\faq_backup\data\ssl` 

5. 確認憑證存放區是受信任的跟憑證授權單位 

6. 下一步完成之後會跳出警告視窗, 選擇是 

7. 匯入成功之後新加入的憑證會出現在最上面 

8. 強制重新整理剛剛的網站(`Ctrl + F5`) 左上角的警告就變成安全連線了! 

## 使用者管理

1. 登入管理後台, 選擇 `Users > Add` 

2. 輸入新的使用者資訊, 按`Save` 

3. 下拉到 `Permissions` 的區塊, 確認 `Active` 和 `Staff` 是勾選的 

4. 在下拉到 `Filter` 的格子裡打上 `faq` 選擇 `Choose all` 最後按 `Save` 

5. 使用者登入之後就可以自由新增修改刪除 `FAQ` 的內容了 

## 故障排除

1. 系統啟用的時候可能會問要不要讓`Docker`存取磁碟
- 選`Share it` 

2. Server 的 [localhost](localhost) 可以連線其他電腦連不到(拒絕存取)
- Server [網路設定](#網路設定)錯誤

3. Server 的 [localhost](localhost) 顯示正常, 其他電腦顯示 `502 Bad Gateway` 
- `.env` 裡面的 `DJANGO_ALLOWED_HOSTS` 後面加上 server 的 IP 

4. 利用 `docker-compose -f .\start_mariadb.yml build --no-cache` 卻失敗了!
- 通常是因為網路問題所以下載失敗, 將剛剛的指令改成以下步驟:
1. `docker-compose -f .\start_mariadb.yml build --no-cache web` 如果失敗就用 `docker-compose -f .\start_mariadb.yml build web` 試到成功為止
2. `docker-compose -f .\start_mariadb.yml build --no-cache nginx` 如果失敗就用 `docker-compose -f .\start_mariadb.yml build nginx` 試到成功為止
- **注意: `--no-cache` 參數一開始一定要下才會有更新的效果**

## 我有問題

有問題可以直接利用留言的功能ㄛ~
滑鼠一到每個區塊的右上角會出現留言的圖示, 按下去就可以進行留言了唷~