WebOS Goodies

WebOS の未来を模索する、ゲームプログラマあがりの Web 開発者のブログ。

WebOS Goodies へようこそ! WebOS はインターネットの未来形。あらゆる Web サイトが繋がり、共有し、協力して創り上げる、ひとつの巨大な情報システムです。そこでは、あらゆる情報がネットワーク上に蓄積され、我々はいつでも、どこからでも、多彩なデバイスを使ってそれらにアクセスできます。 WebOS Goodies は、さまざまな情報提供やツール開発を通して、そんな世界の実現に少しでも貢献するべく活動していきます。
Subscribe       

wget で認証付きサイトをダウンロードする

皆さん、 wget というツールはご存知でしょうか。コマンドラインの HTTP/FTP ダウンロードツールなのですが、これがなかなかに高機能なのです。例えば HTML 中のリンクを辿る再帰的ダウンロードや、絶対パスリンクの相対パスへの変換など、多彩な機能を持っています。きちんと活用すれば、サイトをまるごとダウンロードしてローカルで閲覧することもできます。

さらに、最近ちょっとした事情で認証付きサイトの全コンテンツをダウンロードする必要に迫られまして、この wget で認証をパスできないか試してみました。多少の試行錯誤の末に実現できましたので、本日はその方法をご紹介しようと思います。ついでに使い方も基本から書いてみましたので、 wget を使ったことのない方も、ぜひご一読ください!

wget の入手

wget は非常にメジャーなツールなので、たいていの Linux ディストリビューションにはデフォルトでインストールされているはずです。 Mac なら MacPorts あたりでインストールすれば良いでしょう。 Windows 用には以下のページでコンパイル済みバイナリが配布されています。

http://www.christopherlewis.com/WGet/WGetFiles.htm

また、 Cygwin にも含まれていますので、そちらを使う手もあります。

基本的な使い方

ひとつのファイルをダウンロードするだけなら、コマンドラインで URL を指定するだけです。

wget http://webos-goodies.jp/index.html

これで指定したファイルがダウンロードされ、カレントディレクトリに保存されます。

サイトの内容を丸ごとダウンロードしたいときは、 "-r" (リンクを辿って再帰的にダウンロード)、 "-k" (リンクを相対パスに変換)、 "-E" (text/html のファイルに拡張子 ".html" を付加)といったオプションを付けて、サイトのトップページの URL を指定します。

wget -r -k -E http://webos-goodies.jp/index.html

今度はカレントディレクトリにドメイン名と同じ名前のディレクトリが作成され、その下にサイトと同じ構成で各ファイルが保存されます。画像や CSS, JavaScript などもダウンロードされますので、元のレイアウトがほぼそのまま再現されるはずです。ただし、デフォルトではリンクを辿るのは 5 階層までで、他のドメインへのリンクは無視されます。このあたりはシチュエーションに合わせて後述のオプションで調整してください。

wget のコマンドラインオプション

wget にはとてもたくさんのオプションがあり、とてもすべては掲載しきれません。ここではサイトのダウンロードに使いそうなものに絞ってご紹介しますので、ご了承ください。

HTTP アクセスの制御

今回の目的に直接関係する部分ですね。主に HTTP リクエストヘッダの内容を指定するものです。

--http-user=strBASIC 認証のユーザー名を指定
--http-password=strBASIC 認証のパスワードを指定
--load-cookies file送信する Cookie を file から読み込む
--ignore-lengthContent-Length が間違っていてもリトライしない
--referer=urlリファラーを指定
-U--user-agent=strUser Agent を指定
--header=strHTTP ヘッダを追加

再帰ダウンロードの制御

再帰ダウンロード時にリンクを辿る条件などを指定するオプションです。

-r--recursive再帰的にリンクを辿る
-l--level=nリンクを辿る階層を n までに制限(デフォルト 5)
-np--no-parent上位階層へのリンクは辿らない
-L--relative相対リンク以外は辿らない
--follow-ftpFTP リンクを辿る
-p--page-requisitesHTML の表示に必要なファイルをダウンロードする
-H--span-hosts別ドメインへのリンクも辿る
-D--domain=listリンクを辿るドメインを指定
--exclude-domains listリンクを辿らないドメインを指定
-A--accept list指定したパターンのファイル名のみダウンロード
-R--reject list指定したパターンのファイル名を拒否
-I--include-directories=listダウンロードを許可するディレクトリリストを指定
-X--exclude-directories=listダウンロードを拒否するディレクトリリストを指定
-m--mirror-r -N -l inf --no-remove-listing と等価

ダウンロード・保存の制御

更新チェックや保存時の変換などを制御するオプションです。

-nc--no-clobber既に存在するファイルは無視する
-N--timestamping日付やサイズを比較して変更なければ無視する
-nH--no-host-directoriesホスト名のディレクトリを作らない
--cut-dirs=n保存時に上位 n 階層のディレクトリを作らない
-E--html-extensionHTML ファイルに拡張子 ".html" を付加する
-k--convert-lineHTML 中のリンクを相対指定に書き換える
-K--backup-convertedファイルを書き換えた際にバックアップを作成

これ以外にもたくさんあります。詳細は man ページなどをご参照ください。

認証をパスする方法

さて、いよいよ本題、 wget で認証付きサイトにアクセスする方法をご紹介します。いくつか方法があるので、場合によって使い分けてください。

BASIC 認証の場合

サイトの認証方法が BASIC 認証(ブラウザ標準のダイアログが表示される認証方法)を使っているなら、話は簡単です。前述の "--http-user", "--http-password" のオプションにユーザー名とパスワードを指定するだけでパスできます。例えば、以下のような感じです。

wget --http-user="ユーザー名" --http-password="パスワード" \
    http://webos-goodies.jp/index.html

必要に応じて前述のオプションを追加して、必要なファイルをダウンロードしてください。

永続的な Cookie による認証の場合

永続的な Cookie にセッションキーを保存するタイプの Web サイトに使える方法です。ブラウザを閉じてもログイン状態が持続するサイトはこちらのタイプかもしれません。ただし、すべてではありませんので、もし認証が通らなかった場合は後述の「セッション Cookie による認証」の方法を試してみてください。

このタイプの場合、ブラウザが保存する Cookie ファイルを "--load-cookies" オプションに渡すことで、認証をパスできます。 Firefox の場合は以下の手順で Cookie ファイルが取得できます。

  1. Firefox を起動し、対象の Web サイトにログインする。
  2. ログイン状態のまま Firefox を終了する。
  3. Firefox のプロファイルディレクトリにある "cookies.txt" が Cookie ファイルになります。

IE の場合は、以下の手順になります。

  1. IE を起動し、対象の Web サイトにログインする。
  2. メニューから [ファイル]-[インポートおよびエクスポート]を選択。
  3. ウィザードに従い、 Cookie をファイルにエクスポートする。
  4. エクスポートされたファイルが Cookie ファイルになります。

いずれの場合も、取得した Cookie ファイル(ここでは "cookies.txt" とする)を以下のように指定すれば OK です。

wget --load-cookies=cookies.txt http://webos-goodies/index.html

残念ながら Opera / Safari で Cookie ファイルをエクスポートする方法はわかりませんでした。情報求む。

セッション Cookie による認証

セッション Cookie (ブラウザを閉じると削除される Cookie)にセッション ID を保存するタイプです。セッション Cookie は前述の cookies.txt には保存されないので、その内容を取得するのにはひと工夫必要です。 Opera や Firefox なら Cookie マネージャで Cookie の内容を見ることができますが、ちょっと面倒です。ここでは Firebug を使う方法をご紹介しましょう。

まずは、 Firebug をインストールした Firefox を起動し、対象の Web サイトにログインしてください。そして Firebug の Net タブを開き、ページをリロードします。多数のファイルが読み込まれてグラフが表示されると思いますが、その一番上(ページの HTML ファイル)の "+" をクリックして情報を表示させてください。

Response Headers と Request Headers が表示されますので、 Request Headers の Cookie の値(下の画像の赤線の部分、実際にはもっと長い文字列のはず)をコピーしてください。

あとは、 wget のコマンドラインにその文字列(ここでは "foo=bar")を以下のように指定すれば OK です。

wget --header 'Cookie: foo=bar' http://webos-goodies.jp/index.html

これで指定した Cookie が送出され、認証をパスできます。この文字列には永続的な Cookie も含まれていますので、 Cookie で認証を行うサイトすべてにこの方法が使えます。 Firebug がインストールされているなら、こちらの方が簡単かもしれませんね。

注意点・ Tips など

最後に、私が気付いた点をいくつか挙げておきます。

  • 上記の方法で認証がパスできない場合は、 User Agent をログインに使ったブラウザと同じものにしたり、リファラーにサイト内のページを指定したりするといいかもしれません。
  • CSS 内のリンクは辿らないので、 background-image などで表示されている画像はダウンロードされない事があります。
  • 画像などが他のドメインに保存されている場合は、 "-H", "-D" オプションなどでダウンロード対象のドメインを指定する必要があります。
  • Ajax を活用したサイトなどはダウンロードしても正常に機能しないでしょう。
  • 大量のダウンロードはサーバーに高い負荷をかけます。サイト所有者に迷惑をかけないようにご注意ください。

以上、本日は wget を使って認証付きサイトのコンテンツをダウンロードする方法をご紹介しました。コンテンツをオフラインで見たいというニーズはけっこうあると思いますので、そんなときにぜひご活用ください。

関連記事

この記事にコメントする

Recommendations
Books
「Closure Library」の入門書です。
詳しくはこちらの記事をどうぞ!
Categories
Recent Articles