commit d6128244beee2bed836b9f7f81c9abc9cb1ffe3d Author: David Fifield david@bamsoftware.com Date: Tue Dec 11 20:35:03 2012 -0800

Add instructions for making a Windows browser bundle. --- doc/windows-deployment-howto.txt | 62 ++++++++++++++++++++++++++++++++++++++ 1 files changed, 62 insertions(+), 0 deletions(-)

diff --git a/doc/windows-deployment-howto.txt b/doc/windows-deployment-howto.txt index 2514a1a..8edb7bc 100644 --- a/doc/windows-deployment-howto.txt +++ b/doc/windows-deployment-howto.txt @@ -132,3 +132,65 @@ Build the package. $ python setup.py bdist_wininst This will leave an MSI installer in the dist directory. Double-click it to install M2Crypto amid the other Python files. + +=== 7-Zip + +This is used to build a self-extracting bundle executable. The p7zip +package from Cywin doesn't work because the self-extracting executables +it produces requrie cygwin1.dll. + +http://7-zip.org/download.html +http://downloads.sourceforge.net/project/sevenzip/7-Zip/9.20/7z920.msi + +The sha256sum of the package I used was + +fe4807b4698ec89f82de7d85d32deaa4c772fc871537e31fb0fccf4473455cb8 7z920.msi + +== Browser bundle + +Download the obfsproxy bundle from +https://www.torproject.org/projects/obfsproxy. + +https://www.torproject.org/dist/torbrowser/tor-obfsproxy-browser-2.4.6-alpha... +https://www.torproject.org/dist/torbrowser/tor-obfsproxy-browser-2.4.6-alpha... + +Extract the bundle. + + $ gpg --verify tor-obfsproxy-browser-2.4.6-alpha-2_en-US.exe.asc + $ "/cygdrive/c/Program Files (x86)/7-Zip/7z" x tor-obfsproxy-browser-2.4.6-alpha-2_en-US.exe + $ cd "Tor Browser" + +Copy files into the bundle. We could remove obfsproxy here but don't. +The -n option to cp prevents the existing LIBEAY32.dll and SSLEAY32.dll +from being overwritten. + + $ cp -n ~/flashproxy/dist/flashproxy-client-0.9-win32/{*.pyd,*.dll,*.exe,*.manifest} App + $ mkdir -p Docs/FlashProxy + $ cp ~/flashproxy/dist/flashproxy-client-0.9-win32/{doc/*,README,LICENSE} Docs/FlashProxy + +Make the second half of Data/Tor/torrc look like this (i.e., keep +the generic configuration, but change the obfsproxy-specific stuff). +Basically you are concatenating the normal flashproxy-client torrc, but +changing "./flashproxy-client" to "flashproxy-client". + + UseBridges 1 + # The address and port are ignored by the client transport plugin. + Bridge websocket 0.0.1.0:1 + LearnCircuitBuildTimeout 0 + CircuitBuildTimeout 60 + # Change the second number here (9000) to the number of a port that can + # receive connections from the Internet (the port for which you + # configured port forwarding). + ClientTransportPlugin websocket exec flashproxy-client --register :0 :9000 + +Re-zip the bundle. The "alpha" number should be independent of the +obfsproxy bundle's alpha. + + $ cd .. + $ "/cygdrive/c/Program Files (x86)/7-Zip/7z" a -sfx tor-flashproxy-browser-2.4.6-alpha-1_en-US.exe "Tor Browser" + +Test running the bundle. Extract into a separate directory, double-click +the icon and "Start Tor Browser.exe". + + $ mkdir tmp + $ cp tor-flashproxy-browser-2.4.6-alpha-1_en-US.exe tmp