根據文檔安裝Python及依賴項:setuptools與Jinja2。
雖然文檔裡對Python的版本要求是[2.7,3.0),但我試了發現到目前為止使用最新的Python(3.13.7)沒有遇到任何問題。
默認採用SQLite,無需安裝數據庫。
Trac提供了內置的Standalone Server,因此同樣無需配置服務器。
新建環境: Environment Initialization
trac-admin /path/to/myproject initenv
/path/to/myproject
以斜/
開頭所以應該替換為絶對路徑
它會提示要你輸入項目名稱(默認My Project)與數據庫地址,如果用內置的SQLite的話那麼按回車就可以了。
現在運行
tracd --port 8000 /path/to/myproject
點開顯示在終端機的鏈接就可以看到當前運行的項目列表:此時你看到的應該只有一個My Project,點進去就是一個Trac實例,內置了基本的文檔。此時你可以查閱文檔但無法進行編輯,因為你需要手動配置認證。
.htpasswd
是純文本[.txt]
根據文檔,Windows使用者遇到問題可以檢查一下是否與缺少passlib有關,某些格式的密碼解析時需要用到這個package。
制作.htpasswd
文件可以使用在線密碼生成器,它是純服務端運行的,如果擔心安全問題你可以把它下載到本地。
認證格式:
tracd -p port --basic-auth="base_project_dir,password_file_path,realm" project_path
這裡base_project_dir是相對路徑,password_file_path和project_path都是絶對路徑,realm隨便寫。文檔站提供的示例:
tracd -p 8080 --basic-auth="project1,/path/to/passwordfile,mycompany.com" /path/to/project1
然後進入項目頁面你就會看到右上角多出來一個login,輸入賬號密碼,認證成功後即可對頁面進行編輯,也可以通過GUI配置編輯權限(既然是單機模式那麼我就索性讓所有訪客可編輯)。