git.schokokeks.org
Repositories
Help
Report an Issue
tor-webwml.git
Code
Commits
Branches
Tags
Suche
Strukturansicht:
e24f816d5
Branches
Tags
bridges
docs-debian
jobs
master
press-clips
tor-webwml.git
docs
en
running-a-mirror.wml
remove a couple of distracting characters
Roger Dingledine
commited
e24f816d5
at 2014-10-20 02:34:54
running-a-mirror.wml
Blame
History
Raw
## translation metadata # Revision: $Revision$ # Translation-Priority: 4-optional #include "head.wmi" TITLE="Tor: Running a Mirror" CHARSET="UTF-8" <div id="content" class="clearfix"> <div id="breadcrumbs"> <a href="<page index>">Home » </a> <a href="<page docs/documentation>">Documentation » </a> <a href="<page docs/running-a-mirror>">Running a Mirror</a> </div> <div id="maincol"> <h1>Tor: Running a Mirror</h1> <hr> <p>Thank you for wanting to mirror the Tor website. All of our mirrors are publicly listed on <a href="<page getinvolved/mirrors>">our mirrors page</a>. We've included some sample commands and configuration below to make the initial setup and ongoing maintenance a minimal effort. The Tor website and distribution directory currently require roughly 6 GB of disk space.</p> <h2><a class="anchor" href="#sysconfig">Configuring your System</a></h2> <p> If you would like to run a mirror, it's as easy as these commands to download everything a mirror should share with the world: </p> <tt> <pre> rsync -av --exclude dist --delete rsync://rsync.torproject.org/website-mirror tor-mirror/ rsync -av --delete rsync://rsync.torproject.org/dist-mirror tor-mirror/dist/ </pre> </tt> <p> In order to assure we have reliable and up to date mirrors, please ensure your mirror does at least the following:<br/><br/> Updates <b>no less</b> than every six hours, but no more frequent than every hour.<br/><br/> Allows "Directory Index / Indexes" (Index viewing) of the /dist directory.<br/><br/> Have a valid contact email for administrative communications should your server have issues.<br/><br/> It is highly recommended for all mirror operators to subscribe to <A href="https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-mirrors">tor-mirrors mailing list</A> where all mirror listing modification requests should go (ADD, CHANGE, DELETE, any other requests/notifications). Also, any technical assistance in setting up your mirror may be found here as well.<br/><br/> </p> <br><br> <p> An example cronjob to update a full mirror once every 6 hours may look like so: </p> <tt> <pre> # m h dom mon dow command 0 */6 * * * rsync -aq --exclude dist --delete rsync://rsync.torproject.org/website-mirror/ /var/www/mirrors/torproject.org 5 */6 * * * rsync -aq --delete rsync://rsync.torproject.org/dist-mirror/ /var/www/mirrors/torproject.org/dist </pre> </tt> <p> For mirror operators that use Apache, we have created a sample virtual host configuration file to use: </p> <tt> <pre> <VirtualHost 10.10.10.10:80> ServerAdmin youremail@example.com<br/> ServerName ServerNameHere<br/> DocumentRoot /var/www/mirrors/torproject.org<br/> <Directory /var/www/mirrors/torproject.org/><br/> Options MultiViews Indexes<br/> DirectoryIndex index<br/> AllowOverride None<br/> </Directory><br/> </VirtualHost> </pre> </tt> <p> For mirror operators that use nginx, we created a sample virtual host configuration file to use: </p> <tt> <pre> server { listen 10.10.10.10:80; server_name your.example.com; root /var/www/mirrors/torproject.org; index index.html.en; location / { autoindex on; } } </pre> </tt> <p> If you use nginx, please ensure the text/html line in <tt>/etc/nginx/mime.types</tt> matches: </p> <tt> <pre> text/html en html htm shtml; </pre> </tt> <br/><br> Please ensure that you keep your mirror updated (we suggest automating this task with something like '<tt>cron</tt>'). Our website, source code and binary releases change often. An update frequency of six hours is recommended. Tor users everywhere will thank you. </p> <br/> <h2><a class="anchor" href="#mirrorops">Joining the mirror community</a></h2> <p> If you are running a mirror, please subscribe to the <A href="https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-mirrors">tor-mirrors mailing list</A>, and introduce yourself there. Help for mirror support and configuration issues may also be found on the list. </p> <p> In order to add your mirror, please send a single, comma delimited line of text based on <a href="https://svn.torproject.org/svn/website/trunk/include/tor-mirrors.csv">this file</a> to the mirrors list. Your mirror will then be added manually if it passes availability testing and your provided information is confirmed. Some general pointers on mirrors are: <ol><li> Try not to run your mirror behind a content delivery network (such as Akamai, Cloudflare, Fastly, etc) as most of them block access from countries where the mirror is needed the most.</li> <li> Try not to redirect http to https. Many places in the world cannot use https due to local or national firewalls.</li> </ol> </p> </div> <!-- END MAINCOL --> <div id = "sidecol"> #include "side.wmi" #include "info.wmi" </div> <!-- END SIDECOL --> </div> <!-- END CONTENT --> #include <foot.wmi>