wiki:TracStandalone

Version 4 (modified by trac, 12 years ago) (diff)

--

Tracd

Tracd は軽量なスタンドアロンの Trac web サーバです。ほとんどのケースでは CGI よりセットアップが簡単で、処理速度も速くなります。

利点

  • 依存性が低い: apache その他 web サーバをインストールする必要がありません。
  • 速い: TracModPython バージョン並みに速いはずです (CGI よりはずっと速い)。

欠点

  • 機能が少ない: Tracd に実装されている web サーバはとてもシンプルで、 Apache HTTPD のような詳細なコンフィグレーションはできません。
  • ネイティブで HTTPS をサポートしない: 代わりに sslwrap または STUNNEL を使うことができます。

使用例

ポート 8080 に単一のプロジェクトを作成します。 (http://localhost:8080/)

 $ tracd -p 8080 /path/to/project

複数のプロジェクト(http://localhost:8080/project1/http://localhost:8080/project2/)

 $ tracd -p 8080 /path/to/project1 /path/to/project2

trac は異なったプロジェクトの URL の一意性をパスの後方で保持するため、プロジェクト間でこれらを同じにすることは出来ません。 もし /project1/path/to と /project2/path/to を同時に指定した場合、二つ目のプロジェクトだけしか見えなくなります。

認証を使用する

Tracd は基本認証とダイジェスト認証の両方をサポートします。デフォルトはダイジェスト認証です; 基本認証を使用するためには、以降の例で使用する --auth--basic-auth に置き換え、レルムの指定を削除して下さい。

ファイル /path/to/users.htdigest に project1 のユーザアカウントをレルム "mycompany.com" として保持している場合、以下に示すコマンドラインで tracd を起動します:

 $ tracd -p 8080 --auth project1,/path/to/users.htdigest,mycompany.com /path/to/project1

Note: --auth オプションで指定するプロジェクトの "名前" は、実際には そのプロジェクトの TracEnvironment ディレクトリの basename です。

もちろん、ダイジェストファイルは複数のプロジェクト間で共有することが出来ます:

 $ tracd -p 8080 \
   --auth project1,/path/to/users.htdigest,mycompany.com \
   --auth project2,/path/to/users.htdigest,mycompany.com \
   /path/to/project1 /path/to/project2

Apache 以外の環境でパスワードを生成する

もし Apache が使用できない場合でも、簡単な Python スクリプトでパスワードを生成できます:

from optparse import OptionParser
import md5

# build the options
usage = "usage: %prog [options]"
parser = OptionParser(usage=usage)
parser.add_option("-u", "--username",action="store", dest="username", type = "string",
                  help="the username for whom to generate a password")
parser.add_option("-p", "--password",action="store", dest="password", type = "string",
                  help="the password to use")
(options, args) = parser.parse_args()

# check options
if (options.username is None) or (options.password is None):
   parser.error("You must supply both the username and password")
   
# Generate the string to enter into the htdigest file
realm = 'trac'
kd = lambda x: md5.md5(':'.join(x)).hexdigest()
print ':'.join((options.username, realm, kd([options.username, realm, options.password])))

See also: TracInstall, TracCgi, TracModPython, TracGuide