Merge branch 'long_readme' of git://github.com/wobbol/cjdns into crashey

README.md

@@ -12,82 +12,6 @@ scalability issues that plague existing networks.
 [![Build Status](https://travis-ci.org/cjdelisle/cjdns.svg?branch=master)](https://travis-ci.org/cjdelisle/cjdns)
 [![tip for next commit](https://tip4commit.com/projects/941.svg)](https://tip4commit.com/github/cjdelisle/cjdns)
 
-
-## With built-in security and auto-configuration, everybody can own part of the network
-
-The Internet gives everyone incredible power of expression that was once
-reserved for those wealthy enough to own a radio station or newspaper. Still,
-the Internet's aging protocols have inherent limitations which make them
-unfavorable toward a network owned by the people.
-
-Recent revelations over governments reading our emails have triggered public
-outcry but few stop to imagine the implications of an unsecured
-mesh network, in such a network *everybody* could read your email.
-
-Competition in Internet Access markets worldwide has withered, dominated by a
-few businesses who charge outrageous rates and have not materially increased
-Internet speed since crushing the dial-up providers. Most agree that more market
-diversity is necessary, but if the handful of ISPs we have now cannot be trusted
-to handle our data, there is no reason to expect that the next generation of
-Internet Service Providers would either.
-
-The problem of trust extends beyond private correspondence. The very
-fabric of the Internet can be torn apart by a malicious ISP or even an honest
-mistake. On April 8th, 2010, an employee at China Telecom misconfigured a
-router - causing widespread Internet outages lasting up to fifteen minutes.
-
-As world governments continue pushing to filter websites, there is an ever
-increasing risk of back-and-forth retaliatory filtration eventually leaving
-entire nations isolated and breeding the hate and intolerance which the Internet
-promised to end.
-
-Cjdns was designed with the understanding that for the Internet to continue
-existing without borders, authority over its processes must be decentralized.
-This isn't, and can't be, just a dream - the future of the open Internet is at
-stake.
-
-
-## Security
-
-When you receive a packet of information from the Internet, it seems logical to
-assume that it was meant for you - that it came from the computer which it says
-it came from and that nobody else has read or modified it on the way. While many
-popular software applications are designed around these assumptions, the
-existing Internet does not guarantee any of them and a number of network
-security exploits come from the cases where these assumptions break down.
-
-Cjdns guarantees confidentiality, authenticity and integrity of data by using
-modern cryptography in a non-intrusive way. Information transmitted over a cjdns
-network can't be altered or read en-route. While you can create multiple
-identities, it's practically impossible to impersonate other nodes on the
-network and since a node's IPv6 address is the fingerprint of its key,
-man-in-the-middle attacks are not possible.
-
-
-## Simplicity
-
-Traditional networks require manual configuration of IP addresses. For one to
-get these addresses one must join an Internet Registry and file a lengthy
-application. Cjdns nodes generate their own addresses along with their keys.
-When two nodes find each other, they connect. When many nodes find one another,
-they form a network. General network architecture is of course needed to avoid
-bottlenecks but once the nodes are put in the right places, they will discover
-their roles in the network.
-
-
-## Scalability
-
-Cjdns is built around the bold and unproven assumption that a non-hierarchical
-network can scale. Cjdns uses a [distributed hash table][] to spread the load
-of routing among a number of nodes, rather than requiring every node know the
-exact location of every other node. At the bottom layer, packets are tagged
-with the exact route they should take, think of it like driving directions.
-At the upper layer the nodes maintain and test routes to other nodes who have
-numerically similar IPv6 addresses to their own. Forwarding is achieved by
-sending a packet to physically nearby nodes who have destinations numerically
-close to the target address.
-
-
 ## Testimonials
 
     23:26 <@jercos> well, cjdns is now officially more reliable than the open
@@ -154,6 +78,7 @@ hash table.
 
 ## Documentation
 
+* [Project Goals](doc/projectGoals.md)
 * [Cjdns Whitepaper](doc/Whitepaper.md)
 * [Cjdns on Wikipedia][]
 

README_RU.md

@@ -1,77 +1,13 @@
 # cjdns
 
-[![Build Status](https://travis-ci.org/cjdelisle/cjdns.png?branch=master)](https://travis-ci.org/cjdelisle/cjdns)
+English version of the Readme (она обновляется чаще,):[README.md](README.md)
 
 Безопасная, зашифрованная сеть для обычных людей.
 
 Cjdns — это зашифрованная IPv6 сеть, в которой используются публичные ключи шифрования для присвоения публичного адреса и распределённой таблицы маршрутизации (DHT). Это позволяет создавать сети с очень простой настройкой, которые будут защищены от потенциальных проблем ныне существующих IPv4 и IPv6 сетей.
 
-
-## Зачем?
-
-Для того, чтобы дать обычным людям больше возможностей при обмене информацией.
-
-Cjdns позволяет решить множество проблем текущих сетей. При его использовании вы полностью обладаете своей инфраструктурой обмена информацией.
-
-Кроме того, данный протокол позволяет решить проблему оптимального перераспределения трафика, не делая практически ничего.
-
-Вот простой пример. Сколько у вас дома есть открытых Wi-Fi сетей?
-
-Вероятно, не меньше двух. А теперь представьте, что они работают в Mesh режиме, динамически перенаправляя нагрузку и распределяя трафик.
-
-Централизация власти проявляется в закрытии таких сайтов, как Wikileaks, и любых других — неугодных власти.
-
-В цивилизованном, демократическом обществе каждый должен иметь свободу слова, а цензурироваться могут лишь очевидно-плохие вещи: детская порнография, мошенничество, спам. И конечно, решения о цензуре должно принимать общество, а не правительство.
-
-
-## Как мы близки к финальной версии?
-
-В данный момент работает тестовая сеть, в которой имеется от 500 до 1000 узлов.
-
-Cjdns была протестирована на x86, amd64, ARMv5, ARMv7, MIPS, PowerPC32 и PowerPC64. Тестирование на различных Linux системах продолжается. 
-
-Программное обеспечение работает стабильно, но мы не знаем, как поведут себя в реальном мире наши алгоритмы и протоколы. Пожалуйста, следите за обновлениями cjdns. С помощью тестирования мы сможем определить оптимальный набор алгоритмов и протоколов для использования в реальном мире.
-
-
-## Ты можешь помочь!
-
-Нам нужны добровольцы для тестирования по автоматической сборке cjdns на Apple OS X системе, если вы можете пожертвовать нам деньги для этого дела — напишите нам на почту.
-
-Или же вы можете помочь нам, предоставив 24/7 shell доступ к компьютеру с системой OS X для проведения тестирования.
-
-Всё это можно обсудить в нашем IRC канале.
-
-
-## Анонимность
-
-В отличии от TOR, I2P, и Freenet’a, cjdns планировалась не как анонимная есть. Она не использует случайную маршрутизацию, динамические маршруты и другие технологии для обеспечения анонимности.
-
-Наоборот, cjdns использует самый оптимальный маршрут. Мы пошли на такой шаг, для обеспечения максимальной производительности.
-
-С другой стороны, некий уровень анонимности всё же присутствует. Для того, чтобы определить ваше физическое положение на основе вашего cjdns адреса, потребуется сделать трассировку по IPv4 адресам от конечной ноды до вас, запросив информацию по проходящему трафику от операторов всех транзитных нод.
-
-
-## Безопасность
-
-Когда вы получаете информационный пакет из интернета, это означает, что он предназначен для вас, но никто не знает, модифицировался ли пакет по пути или же нет. Множество программ, которые взаимодействуют с интернетом, не проверяют неизменность пакета, а такие программно-аппаратные средства, как DPI, могут вносить значительные изменения в пакеты.
-
-Cjdns гарантирует, что пакет по пути был не кем не модифицирован, что подтверждается криптографическими средствами, которые используются в этом протоколе.
-
-Cjdns защищает информацию которая поступает к вам, от использования заведомо ложного маршрута, что позволяет полностью избежать атаки man-in-the-middle.
-
-
-## Простота
-
-Представьте себе такую компьютерную сеть, в которой всё, что нужно сделать инженеру — это подключить компьютер сетевым кабелем, а компьютер сам узнает, как найти других и сам сконфигурируется.
-
-Это и есть основная цель cjdns. Конечно же, сетевые специалисты всё еще будут нужны для решения сложных технических вопросов, но большую часть решения проблем сможет взять на себя cjdns.
-
-
-## Масштабируемость
-
-С основе Cjdns лежат принципы одноранговой сети, таким образом, cjdns может масштабироваться бесконечно — нет большой нагрузки на какой-то определенный узел.
-Cjdns использует распределенную хэш таблицу (DHT) для обмена маршрутами, это позволяет не иметь карту всей сети каждому узлу (не раздувать таблицу маршрутов).
-
+[![Build Status](https://travis-ci.org/cjdelisle/cjdns.png?branch=master)](https://travis-ci.org/cjdelisle/cjdns)
+[![For next commit](https://tip4commit.com/projects/941.svg)](https://tip4commit.com/github/cjdelisle/cjdns)
 
 ## Рекомендательные письма
 
@@ -104,17 +40,37 @@ DNS — это сложная система, которую трудно реа
 Cjdns — это совмещение двух слов cjd и DNS, но проект поменял направление своего развития практически в начале, и у него всё еще нет замены DNS, но имя осталось. Можете придумать свою расшифровку названия, если хотите.
 
 
-## Что еще почитать
+Спасибо за ваше время и интерес,
+Caleb James DeLisle  ==  cjdelisle  ==  cjd
+
+## Community
 
-Пожалуйста, прочтите [спецификацию](rfcs/Whitepaper.md)
+* irc://irc.efnet.org/#cjdns_ru ([web client][IRC Web])
+* [Hyperboria][]
+* [Project Meshnet][]
+* [/r/darknetplan][]
+* [#cjdns on Twitter][]
 
-Если вам всё еще интересен проект — присоединяйтесь к обсуждению в IRC:
 
-  * irc://irc.EFNet.org/#cjdns
-  * http://chat.efnet.org:9090/?channels=%23cjdns&Login=Login
+## Documentation
+
+* [Project Goals](doc/projectGoals_ru.md)(RU)
+* [Cjdns Whitepaper](doc/Whitepaper.md)
+* [Cjdns on Wikipedia][]
+
+Advanced configuration:
+
+* [Setup a cjdns NAT gateway for your LAN](doc/nat-gateway.md)
+* [Install cjdns on OpenIndiana](doc/open-indiana.md)
+
+### License
+
+[Available here](LICENSE)
+
+Thank you for your time and interest,
+
+The cjdns developers.
 
-Спасибо за ваше время и интерес,
-Caleb James DeLisle  ==  cjdelisle  ==  cjd
 
 --------------------------------------------------------------------------------
 
@@ -297,3 +253,19 @@ Cjdns поставляется с библиотекой для python, кото
 
 
 [beyond pain]: https://lists.torproject.org/pipermail/tor-dev/2012-October/004063.html
+[IRC Web]: http://chat.efnet.org/irc.cgi?chan=%23cjdns_ru
+[Hyperboria]: http://hyperboria.net
+[Project Meshnet]: https://projectmeshnet.org
+[/r/darknetplan]: http://www.reddit.com/r/darknetplan
+[#cjdns on Twitter]: https://twitter.com/hashtag/cjdns
+[Project Meshnet Map]: http://map.projectmeshnet.org
+[Buildbots]: https://buildbot.meshwith.me/cjdns/waterfall
+
+[Cjdns on Wikipedia]: https://ru.wikipedia.org/wiki/Cjdns
+[Distributed Hash Table]: https://ru.wikipedia.org/wiki/Distributed_hash_table
+[Beyond Pain]: https://lists.torproject.org/pipermail/tor-dev/2012-October/004063.html
+[Kademlia]: https://ru.wikipedia.org/wiki/Kademlia
+
+[Tor]: https://www.torproject.org
+[I2P]: http://www.i2p2.de
+[Freenet]: https://freenetproject.org

doc/projectGoals.md

@@ -0,0 +1,75 @@
+# Project goals
+
+## With built-in security and auto-configuration, everybody can own part of the network
+
+The Internet gives everyone incredible power of expression that was once
+reserved for those wealthy enough to own a radio station or newspaper. Still,
+the Internet's aging protocols have inherent limitations which make them
+unfavorable toward a network owned by the people.
+
+Recent revelations over governments reading our emails have triggered public
+outcry but few stop to imagine the implications of an unsecured
+mesh network, in such a network *everybody* could read your email.
+
+Competition in Internet Access markets worldwide has withered, dominated by a
+few businesses who charge outrageous rates and have not materially increased
+Internet speed since crushing the dial-up providers. Most agree that more market
+diversity is necessary, but if the handful of ISPs we have now cannot be trusted
+to handle our data, there is no reason to expect that the next generation of
+Internet Service Providers would either.
+
+The problem of trust extends beyond private correspondence. The very
+fabric of the Internet can be torn apart by a malicious ISP or even an honest
+mistake. On April 8th, 2010, an employee at China Telecom misconfigured a
+router - causing widespread Internet outages lasting up to fifteen minutes.
+
+As world governments continue pushing to filter websites, there is an ever
+increasing risk of back-and-forth retaliatory filtration eventually leaving
+entire nations isolated and breeding the hate and intolerance which the Internet
+promised to end.
+
+Cjdns was designed with the understanding that for the Internet to continue
+existing without borders, authority over its processes must be decentralized.
+This isn't, and can't be, just a dream - the future of the open Internet is at
+stake.
+
+
+## Security
+
+When you receive a packet of information from the Internet, it seems logical to
+assume that it was meant for you - that it came from the computer which it says
+it came from and that nobody else has read or modified it on the way. While many
+popular software applications are designed around these assumptions, the
+existing Internet does not guarantee any of them and a number of network
+security exploits come from the cases where these assumptions break down.
+
+Cjdns guarantees confidentiality, authenticity and integrity of data by using
+modern cryptography in a non-intrusive way. Information transmitted over a cjdns
+network can't be altered or read en-route. While you can create multiple
+identities, it's practically impossible to impersonate other nodes on the
+network and since a node's IPv6 address is the fingerprint of its key,
+man-in-the-middle attacks are not possible.
+
+
+## Simplicity
+
+Traditional networks require manual configuration of IP addresses. For one to
+get these addresses one must join an Internet Registry and file a lengthy
+application. Cjdns nodes generate their own addresses along with their keys.
+When two nodes find each other, they connect. When many nodes find one another,
+they form a network. General network architecture is of course needed to avoid
+bottlenecks but once the nodes are put in the right places, they will discover
+their roles in the network.
+
+
+## Scalability
+
+Cjdns is built around the bold and unproven assumption that a non-hierarchical
+network can scale. Cjdns uses a [distributed hash table][] to spread the load
+of routing among a number of nodes, rather than requiring every node know the
+exact location of every other node. At the bottom layer, packets are tagged
+with the exact route they should take, think of it like driving directions.
+At the upper layer the nodes maintain and test routes to other nodes who have
+numerically similar IPv6 addresses to their own. Forwarding is achieved by
+sending a packet to physically nearby nodes who have destinations numerically
+close to the target address.

doc/projectGoals_ru.md

@@ -0,0 +1,65 @@
+# Project Goals
+## Зачем?
+
+Для того, чтобы дать обычным людям больше возможностей при обмене информацией.
+
+Cjdns позволяет решить множество проблем текущих сетей. При его использовании вы полностью обладаете своей инфраструктурой обмена информацией.
+
+Кроме того, данный протокол позволяет решить проблему оптимального перераспределения трафика, не делая практически ничего.
+
+Вот простой пример. Сколько у вас дома есть открытых Wi-Fi сетей?
+
+Вероятно, не меньше двух. А теперь представьте, что они работают в Mesh режиме, динамически перенаправляя нагрузку и распределяя трафик.
+
+Централизация власти проявляется в закрытии таких сайтов, как Wikileaks, и любых других — неугодных власти.
+
+В цивилизованном, демократическом обществе каждый должен иметь свободу слова, а цензурироваться могут лишь очевидно-плохие вещи: детская порнография, мошенничество, спам. И конечно, решения о цензуре должно принимать общество, а не правительство.
+
+
+## Как мы близки к финальной версии?
+
+В данный момент работает тестовая сеть, в которой имеется от 500 до 1000 узлов.
+
+Cjdns была протестирована на x86, amd64, ARMv5, ARMv7, MIPS, PowerPC32 и PowerPC64. Тестирование на различных Linux системах продолжается. 
+
+Программное обеспечение работает стабильно, но мы не знаем, как поведут себя в реальном мире наши алгоритмы и протоколы. Пожалуйста, следите за обновлениями cjdns. С помощью тестирования мы сможем определить оптимальный набор алгоритмов и протоколов для использования в реальном мире.
+
+
+## Ты можешь помочь!
+
+Нам нужны добровольцы для тестирования по автоматической сборке cjdns на Apple OS X системе, если вы можете пожертвовать нам деньги для этого дела — напишите нам на почту.
+
+Или же вы можете помочь нам, предоставив 24/7 shell доступ к компьютеру с системой OS X для проведения тестирования.
+
+Всё это можно обсудить в нашем IRC канале.
+
+
+## Анонимность
+
+В отличии от TOR, I2P, и Freenet’a, cjdns планировалась не как анонимная есть. Она не использует случайную маршрутизацию, динамические маршруты и другие технологии для обеспечения анонимности.
+
+Наоборот, cjdns использует самый оптимальный маршрут. Мы пошли на такой шаг, для обеспечения максимальной производительности.
+
+С другой стороны, некий уровень анонимности всё же присутствует. Для того, чтобы определить ваше физическое положение на основе вашего cjdns адреса, потребуется сделать трассировку по IPv4 адресам от конечной ноды до вас, запросив информацию по проходящему трафику от операторов всех транзитных нод.
+
+
+## Безопасность
+
+Когда вы получаете информационный пакет из интернета, это означает, что он предназначен для вас, но никто не знает, модифицировался ли пакет по пути или же нет. Множество программ, которые взаимодействуют с интернетом, не проверяют неизменность пакета, а такие программно-аппаратные средства, как DPI, могут вносить значительные изменения в пакеты.
+
+Cjdns гарантирует, что пакет по пути был не кем не модифицирован, что подтверждается криптографическими средствами, которые используются в этом протоколе.
+
+Cjdns защищает информацию которая поступает к вам, от использования заведомо ложного маршрута, что позволяет полностью избежать атаки man-in-the-middle.
+
+
+## Простота
+
+Представьте себе такую компьютерную сеть, в которой всё, что нужно сделать инженеру — это подключить компьютер сетевым кабелем, а компьютер сам узнает, как найти других и сам сконфигурируется.
+
+Это и есть основная цель cjdns. Конечно же, сетевые специалисты всё еще будут нужны для решения сложных технических вопросов, но большую часть решения проблем сможет взять на себя cjdns.
+
+
+## Масштабируемость
+
+С основе Cjdns лежат принципы одноранговой сети, таким образом, cjdns может масштабироваться бесконечно — нет большой нагрузки на какой-то определенный узел.
+Cjdns использует распределенную хэш таблицу (DHT) для обмена маршрутами, это позволяет не иметь карту всей сети каждому узлу (не раздувать таблицу маршрутов).