專案管理

​

檢視專案稽核日誌

管理員可以查看每個專案的稽核日誌（Audit Log）。此稽核日誌會顯示各種事件，例如連結分享在私人／權杖式之間切換的時間、邀請的寄送／接受時間，以及使用者透過權杖加入專案的時間。管理員可以透過 Your Instance -> Admin -> Manage Users 逐一檢視各專案的日誌，接著：

• 搜尋使用者
• 點選 Projects 分頁
• 選擇一個專案
• 點選 (i) 圖示
• 點選 Audit Log 分頁

如果專案已分享給指定的協作者（透過其電子郵件地址），當收件者加入後，他們會連同其權限一起列在分享視窗中，供專案擁有者查看。管理員透過管理面板檢視該專案的 Project Info 分頁時，也會看到這些資訊。

​

復原已刪除的文件

1. 使用您的管理員憑證登入
2. 點選 Admin 並選擇 Manage Users
3. 在搜尋欄位中輸入您要為其復原文件之使用者的電子郵件
4. 在搜尋結果清單中點選其電子郵件地址，開啟該使用者的資訊頁面
5. 點選 Projects 分頁，並使用搜尋欄位搜尋該專案
6. 點選專案名稱旁的資訊圖示，開啟 Project Info
7. 點選 Deleted Docs 分頁
8. 點選已刪除文件旁的 Undelete 按鈕，將其復原至使用者的專案中。

復原後的檔案會採用以下格式：FILENAME-TIMESTAMP.EXTENSION。例如，main.tex 的復原版本會以檔名 main-2024-02-23-130441542.tex 復原至專案的根目錄。

​

轉移專案擁有權

Server Pro 的管理面板中，每個專案都有專屬的頁面。您可以在「/admin/user」上搜尋使用者，前往其 Projects 分頁，在清單中找到該專案並點選資訊圖示來進入；或者在已知專案 ID 的情況下，直接前往 https://your-instance-url/admin/project/ 頁面。在專案資訊頁面上，您可以找到 Transfer Ownership 按鈕，點選後會開啟一個視窗，讓您指定任何使用者作為新擁有者。新擁有者不需要是該專案的現有協作者。

請注意，在擁有權轉移過程中，原擁有者會被加入為具有讀寫權限的專案協作者。

​

更新專案編譯逾時

目前專案的預設編譯逾時設定為 180 秒。此數值可以變更，需要兩個步驟。

首先，編輯 config/variables.env 檔案，新增 COMPILE_TIMEOUT 環境變數，並將其值設為所需的逾時秒數。例如，COMPILE_TIMEOUT=300 代表 5 分鐘。

將逾時設定超過 10 分鐘並沒有意義。如果這麼做，您很可能會在應用程式的其他元件中遇到逾時。

完成此變更後，您需要執行 bin/up -d 指令重新建立 sharelatex 容器。

設定此環境變數只會更新新使用者的逾時值，不會追溯套用至現有使用者，因為此值是在使用者首次建立時填入的。

若要調整現有使用者的逾時，您需要變更資料庫中的每筆使用者記錄。我們建議您在執行此操作時務必謹慎，並在進行任何變更之前先做一次一致性備份。

您可以在這裡找到關於執行備份的資訊。

若要更新所有現有使用者的編譯逾時值，您需要在 Docker 主機上執行以下 shell 指令：

echo 'db.users.updateMany({}, {$set: {"features.compileTimeout": <value>}})' | docker exec -i mongo mongosh --quiet localhost/sharelatex

您需要將上述查詢中的 <value> 替換為所需的逾時秒數。

指令完成後，您應該會看到一則確認訊息，其中包含已修改的記錄數量。接著您可以輸入 exit 並按下 Enter 鍵，返回主機 shell。

​

追蹤專案存取

您可以使用以下指令查看專案在何時被誰載入：

docker exec sharelatex bash -c 'grep "join project request" /var/log/overleaf/web.log'

這會同時提供 timestamp、user_id 與 project_id。