部署

本文將講述如何在生產環境部署 MineAdmin 的前後端應用程式

後端

服務部署

一般來說，在新一代服務端應用程式。基本上都是由 docker 進行服務部署。 MineAdmin 也提供了開箱即用的 Dockerfile 以便你能夠進行快速的服務部署 在某些情況可能需要面臨裸裝部署在伺服器中。以下介紹兩種部署方式。以便快速上手

直接部署在伺服器中

如果你需要將 MineAdmin 直接部署在伺服器中。那麼首先伺服器要滿足以下系統條件

TIP

php 與擴充套件安裝請自行搜尋相關教程，本處不另行說明

• PHP >= 8.1
• cURL PHP 擴充套件
• Fileinfo PHP 擴充套件
• OpenSSL PHP 擴充套件
• PDO 擴充套件
• Redis 擴充套件
• Json 擴充套件
• PDO_MYSQL 擴充套件 (可選)
• PDO_PGSQL 擴充套件 (可選)
• Swoole >= 5.1 擴充套件 (可選)
• Swow >= 1.5 or develop (可選)

進入專案目錄執行

php bin/hyperf.php start

即可啟動成功

預設的程式不提供常駐程序選項，我們推薦使用第三方應用例如 supervisord來進行專案的程序持久化執行 如何使用請參考 Hyperf文件

以容器形式部署 (推薦)

如果你想要以容器服務形式向外提供應用服務。可以使用專案下的 Dockerfile,用法很簡單。

首先要保證伺服器已經安裝完成 docker

然後進入你的專案目錄

cd yourProject

執行 docker build . -t mineadmin 來打包映象

# -t 引數具體請自行百度，此處不另行說明
docker build . -t mineadmin

接下來執行 docker run 來啟動一個容器

docker run -d --name mineadmin mineadmin

即可完成專案服務端的部署

---

TIP

以上兩種部署方式的前提是已經配置好 .env 檔案

反向代理

無論何時都不建議將應用程式直接暴露在公網環境，最好是再套一層代理轉發

本文將列舉幾個反向代理示例

Nginx

如果你將程式部署在執行 nginx 的伺服器上。你可以參考以下反向代理配置檔案來作為站點的起點。

#PROXY-START/server

location ^~ /
{
    # 應用程式埠
    proxy_pass http://127.0.0.1:9501/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_http_version 1.1;
    # proxy_hide_header Upgrade;

    add_header X-Cache $upstream_cache_status;
    #Set Nginx Cache

    set $static_fileyqrHU0ll 0;
    if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
    {
        set $static_fileyqrHU0ll 1;
        expires 1m;
    }
    if ( $static_fileyqrHU0ll = 0 )
    {
        add_header Cache-Control no-cache;
    }
}
#PROXY-END/

K8s Ingress

如果你將程式部署在 k8s 叢集中，你可以參考以下配置說明

建立服務

# Kubernetes API 的版本
apiVersion: v1
# 資源物件型別是服務（Service）
kind: Service
# 服務的元資料資訊
metadata:
  # 為這個服務指定一個名稱
  name: mineadmin-service
# 服務的規範部分
spec:
  # 用於選擇與該服務關聯的 Pod
  selector:
    app: mineadmin-server
  # 服務暴露的埠
  ports:
    - protocol: TCP
      port: 80
      targetPort: 9501

建立 Ingress 資源

apiVersion: networking.k8s.io/v1
# 定義的資源物件型別是 Ingress
kind: Ingress
metadata:
  # 為這個 Ingress 資源指定一個名稱
  name: mineadmin-ingress
  annotations:
    # 重寫的目標路徑
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  # Ingress 的路由規則列表
  rules:
      # 適用於主機名為 www.mineadmin.com 的請求
    - host: www.mineadmin.com
      # 處理 HTTP 請求
      http:
        paths:
          # 匹配的路徑為根路徑
          - path: /
            # 指定路徑的匹配型別為字首匹配
            pathType: Prefix
            # 定義了請求被路由到的後端服務
            backend:
              # 指定後端服務為一個 Kubernetes 服務
              service:
                # 指定後端服務的名稱為 “mineadmin-service”，即前面定義的服務。
                name: mineadmin-service
                # 後端服務的埠號為 80。當請求被路由到後端服務時，將被轉發到這個埠上。
                port:
                  number: 80

除錯模式

在 config/config.php 配置檔案中，除錯選項決定了有多少錯誤資訊實際上會展示給使用者，預設情況下，該選項 設定遵守環境變數 APP_DEBUG 的值.該值儲存在你的專案 .env 檔案中.

WARNING

在生產環境中，該值應該永遠為 false.如果在生產環境中設定為 true 將有可能把敏感資訊返回給使用者的風險

前端

服務部署

直接部署在伺服器中

如果你想要將 MineAdmin 前端服務部署在伺服器中，以經典的 Nginx 服務為例。

首先生成 靜態資源,在你的專案 web 目錄下執行 pnpm build 生成 PS: 可以在伺服器進行生成， 也可以在本地預先生成好

將你的靜態資源扔到站點目錄。即可完成安裝

以容器服務形式部署（推薦）

與後端一致，我們提供了前端打包的 Dockerfile， 進入你的 應用程式/web 目錄下，執行

docker build . -t frontend

即可打包成 nginx 映象

根據該映象即可啟動一個容器服務

docker run -d --name frontend frontend

配置站點反向代理到[容器IP:80] 埠即完成部署