Update README-zh-cn.md
translate the latest README.md to Chinese. Not a machine translation because I am a native Chinese speaker.
This commit is contained in:
momordica2020
GitHub
parent
08b9c0ed4a
commit
97d8d3d3b6
1 changed files with 211 additions and 54 deletions
265
README-zh-cn.md
265
README-zh-cn.md
|
|
@ -1,81 +1,238 @@
|
||||||
# zeronet-conservancy
|
# zeronet-conservancy
|
||||||
|
|
||||||
**警告**：这个翻译已经过时了。请阅读英文版。对此翻译的任何贡献都将受到高度赞赏
|
|
||||||
|
|
||||||
[](https://repology.org/project/zeronet-conservancy/versions)
|
[](https://repology.org/project/zeronet-conservancy/versions)
|
||||||
|
|
||||||
[in English](README.md) | [em português](README-ptbr.md) | [по-русски](README-ru.md) | [日本語](README-ja.md)
|
**(注意：本文档的翻译版本通常滞后于最新内容)**
|
||||||
|
|
||||||
## 为什么？
|
[по-русски](README-ru.md) | [em português](README-ptbr.md) | [简体中文](README-zh-cn.md) | [日本語](README-ja.md)
|
||||||
|
|
||||||
* 我们相信开放，自由，无审查的网络和通讯
|
`zeronet-conservancy` 是 [零网 ZeroNet](https://github.com/HelloZeroNet/ZeroNet) 项目的一个分支/延续（其创建者已放弃维护），致力于维持现有的p2p网络，进一步发扬去中心化与自由的价值观，并逐步得到一个设计得更好的网络。
|
||||||
* 不会受单点故障影响：只要有在线的节点，站点就会保持在线
|
|
||||||
* 无托管费用：站点由访问者托管
|
|
||||||
* 无法关闭：因为节点无处不在
|
|
||||||
* 快速并可离线运行：即使没有互联网连接也可以使用
|
|
||||||
|
|
||||||
|
## 本分支的状况
|
||||||
|
|
||||||
|
在onion-v3切换危机期间，我们需要一个能够支持onion-v3，且不仅仅依赖于个别开发者的可信的分支。本分支从实现这一任务开始，对 [ZeroNet/py3](https://github.com/HelloZeroNet/ZeroNet/tree/py3) 分支作了最少的改动，从而让任何人都可以轻松地审计这些改动。
|
||||||
|
|
||||||
|
目前，0net正陷入前所未有的危机，而本分支似乎是唯一存活下来的。我们的开发进展缓慢，但其中的部分工作正在幕后进行。如果你完全是个0net的新手，且没有人指导你，而且你也不是开发者的话，我们建议请等待v0.8版本发布。
|
||||||
|
|
||||||
|
## 为何选择0net？
|
||||||
|
|
||||||
|
* 我们相信开放、自由和不受审查的网络与通讯。
|
||||||
|
* 不受单点故障影响：只要至少有一个节点在提供服务，站点就能保持在线。
|
||||||
|
* 无需托管费用：站点由访问者们来共同托管。
|
||||||
|
* 无法被关停：因为节点无处不在。
|
||||||
|
* 快速并且支持离线访问：即使没有互联网，你也可以访问站点。
|
||||||
|
|
||||||
## 功能
|
## 功能
|
||||||
* 实时站点更新
|
* 实时更新站点
|
||||||
* 安装方便：只需解压并运行
|
* 一键克隆已有的站点
|
||||||
* 一键克隆存在的站点
|
* 使用私钥/公钥的免密码认证
|
||||||
* 无需密码、基于 [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki)
|
* 内置SQL服务器，支持P2P数据同步，便于动态站点开发
|
||||||
的认证：您的账户被与比特币钱包相同的加密方法保护
|
* 匿名性：支持采用.onion匿踪服务的Tor网络（支持onion-v3）
|
||||||
* 内建 SQL 服务器和 P2P 数据同步：让开发更简单并提升加载速度
|
* TLS加密连接（会经过明网）
|
||||||
* 匿名性：完整的 Tor 网络支持，支持通过 .onion 隐藏服务相互连接而不是通过 IPv4 地址连接
|
* 自动开启uPnP端口（可选）
|
||||||
* TLS 加密连接
|
* 支持多用户插件（openproxy）
|
||||||
* 自动打开 uPnP 端口
|
* 兼容任何现代浏览器/操作系统
|
||||||
* 多用户（openproxy）支持的插件
|
* 离线站点可通过其他方式进行同步（或当连接恢复时同步）
|
||||||
* 适用于任何浏览器 / 操作系统
|
|
||||||
|
|
||||||
|
## 它是如何工作的？
|
||||||
|
|
||||||
## 原理
|
* 启动`zeronet.py`后，你可以通过以下方式访问zeronet站点： `http://127.0.0.1:43110/{零网站点地址}` （例如 `http://127.0.0.1:43110/1MCoA8rQHhwu4LY2t2aabqcGSRqrL8uf2X/`）
|
||||||
|
* 当你访问一个新站点时，它会通过BitTorrent网络来寻找可用节点，从这些节点下载站点所需的文件（如html, css, js...）。
|
||||||
|
* 每个你访问过的站点也由你提供托管服务。
|
||||||
|
* 每个站点包含一个`content.json`文件，其中包含着由本站所有文件生成的sha512哈希值以及由站点私钥生成的签名。
|
||||||
|
* 如果站点拥有者（即持有站点私钥的人）对站点内容进行了修改，则他/她会重新签署`content.json`文件并发布至其他节点。随后，其他节点会验证`content.json`的完整性（通过签名），并下载被修改的文件，随后将更新过的内容继续发布给其他节点。
|
||||||
|
|
||||||
* 在运行 `zeronet.py` 后，您将可以通过
|
以下链接来自原版ZeroNet：
|
||||||
`http://127.0.0.1:43110/{zeronet_address}`（例如：
|
|
||||||
`http://127.0.0.1:43110/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D`）访问 zeronet 中的站点
|
|
||||||
* 在您浏览 zeronet 站点时，客户端会尝试通过 BitTorrent 网络来寻找可用的节点，从而下载需要的文件（html，css，js...）
|
|
||||||
* 您将会储存每一个浏览过的站点
|
|
||||||
* 每个站点都包含一个名为 `content.json` 的文件，它储存了其他所有文件的 sha512 散列值以及一个通过站点私钥生成的签名
|
|
||||||
* 如果站点的所有者（拥有站点地址的私钥）修改了站点，并且他 / 她签名了新的 `content.json` 然后推送至其他节点，
|
|
||||||
那么这些节点将会在使用签名验证 `content.json` 的真实性后，下载修改后的文件并将新内容推送至另外的节点
|
|
||||||
|
|
||||||
#### [关于 ZeroNet 加密，站点更新，多用户站点的幻灯片 »](https://docs.google.com/presentation/d/1_2qK1IuOKJ51pgBvllZ9Yu7Au2l551t3XBgyTSvilew/pub?start=false&loop=false&delayms=3000)
|
|
||||||
#### [常见问题 »](https://zeronet.io/docs/faq/)
|
|
||||||
|
|
||||||
#### [ZeroNet 开发者文档 »](https://zeronet.io/docs/site_development/getting_started/)
|
|
||||||
|
|
||||||
|
|
||||||
## 屏幕截图
|
|
||||||
|
|
||||||
#### [ZeroNet 文档中的更多屏幕截图 »](https://zeronet.io/docs/using_zeronet/sample_sites/)
|
|
||||||
|
|
||||||
|
- [关于ZeroNet加密、站点更新、多用户站点的演示文稿 »](https://docs.google.com/presentation/d/1_2qK1IuOKJ51pgBvllZ9Yu7Au2l551t3XBgyTSvilew/pub?start=false&loop=false&delayms=3000)
|
||||||
|
- [常见问题解答 »](https://zeronet.io/docs/faq/)
|
||||||
|
- [ZeroNet开发者文档 »](https://zeronet.io/docs/site_development/getting_started/)（已过时）
|
||||||
|
|
||||||
## 如何加入
|
## 如何加入
|
||||||
|
|
||||||
|
### 从发行版仓库安装
|
||||||
|
|
||||||
|
- NixOS: [搜索zeronet-conservancy软件包](https://search.nixos.org/packages?from=0&size=50&sort=relevance&type=packages&query=zeronet-conservancy)（并参见下方）
|
||||||
|
- ArchLinux: [最新发行版](https://aur.archlinux.org/packages/zeronet-conservancy)，[最新git版](https://aur.archlinux.org/packages/zeronet-conservancy-git)
|
||||||
|
|
||||||
|
### 从Nix包管理器安装（Linux 或 MacOS）
|
||||||
|
|
||||||
|
- 安装并配置nix包管理器（如果需要的话）
|
||||||
|
- `nix-env -iA nixpkgs.zeronet-conservancy`
|
||||||
|
|
||||||
|
如果您使用的是NixOS系统，将`zeronet-conservancy`添加到系统配置中
|
||||||
|
|
||||||
|
（感谢 @fgaz 制作并维护此软件包）
|
||||||
|
|
||||||
|
### 从源代码安装
|
||||||
|
|
||||||
|
#### 系统依赖项
|
||||||
|
|
||||||
|
##### 通用的类Unix系统（包括MacOS X）
|
||||||
|
|
||||||
|
安装autoconf和其他基本开发工具，python3和pip，然后看“构建python依赖”
|
||||||
|
|
||||||
|
##### 基于Apt的系统（debian、ubuntu等）
|
||||||
|
- `sudo apt update`
|
||||||
|
- `sudo apt install git pkg-config libffi-dev python3-pip python3-venv python3-dev build-essential libtool`
|
||||||
|
|
||||||
|
##### 基于Red Hat和Fedora的系统
|
||||||
|
- `yum install epel-release -y 2>/dev/null`
|
||||||
|
- `yum install git python3 python3-wheel`
|
||||||
|
|
||||||
|
##### 基于Fedora系统的dandified包管理器
|
||||||
|
- `sudo dnf install git python3-pip python3-wheel -y`
|
||||||
|
|
||||||
|
##### openSUSE
|
||||||
|
- `sudo zypper install python3-pip python3-setuptools python3-wheel`
|
||||||
|
|
||||||
|
##### 基于Arch和Manjaro的系统
|
||||||
|
- `sudo pacman -S git python-pip -v --no-confirm`
|
||||||
|
|
||||||
|
##### Android/Termux
|
||||||
|
- 安装 [Termux](https://termux.com/)（在Termux中可以通过以下命令安装包`pkg install <package-names>`）
|
||||||
|
- `pkg update`
|
||||||
|
- `pkg install python automake git binutils libtool`
|
||||||
|
- （在旧Android系统上可能还需安装这个）`pkg install openssl-tool libcrypt clang`
|
||||||
|
- （若安装了上述包仍在启动时遇到问题，请告诉我们）
|
||||||
|
- （可选）`pkg install tor`
|
||||||
|
- （可选）通过以下命令运行Tor：`tor --ControlPort 9051 --CookieAuthentication 1`（你可以通过右滑来打开新会话）
|
||||||
|
|
||||||
|
#### 构建python依赖、虚拟环境、运行
|
||||||
|
- 克隆此repo（注意：在Android/Termux上应将其克隆到Termux的“home”文件夹中，这是因为虚拟环境无法位于`storage/`）
|
||||||
|
- `python3 -m venv venv`（创建python虚拟环境，命令末尾的`venv`只是个名称，若使用其他名称，需在后续命令中替换）
|
||||||
|
- `source venv/bin/activate`（激活环境）
|
||||||
|
- `python3 -m pip install -r requirements.txt`（安装依赖）
|
||||||
|
- `python3 zeronet.py`（**运行zeronet-conservancy！**）
|
||||||
|
- 在浏览器中打开登录页面：http://127.0.0.1:43110/
|
||||||
|
- 需要在新的终端再次启动的话，进入repo目录并执行：
|
||||||
|
- `source venv/bin/activate`
|
||||||
|
- `python3 zeronet.py`
|
||||||
|
|
||||||
|
#### （可选用）在NixOS上
|
||||||
|
|
||||||
|
- 克隆此repo
|
||||||
|
- 进入已经安装过依赖的shell：`nix-shell '<nixpkgs>' -A zeronet-conservancy`
|
||||||
|
- `./zeronet.py`
|
||||||
|
|
||||||
|
#### （可选用）构建Docker镜像
|
||||||
|
- 构建0net镜像：`docker build -t 0net-conservancy:latest . -f Dockerfile`
|
||||||
|
- 或构建集成tor的0net镜像：`docker build -t 0net-conservancy:latest . -f Dockerfile.integrated_tor`
|
||||||
|
- 运行它：`docker run --rm -it -v </path/to/0n/data/directory>:/app/data -p 43110:43110 -p 26552:26552 0net-conservancy:latest`
|
||||||
|
- /path/to/0n/data/directory - 该目录保存所有数据，包括你的私钥证书。如果在生产模式下运行，请千万不要删除这个文件夹！
|
||||||
|
- 也可以通过docker-compose运行：`docker compose up -d 0net-conservancy` 来启动两个容器——0net和tor各自运行。
|
||||||
|
- 或者在同一个容器中运行0net和tor：`docker compose up -d 0net-tor` 。
|
||||||
|
（请检查上述说明是否仍然可行）
|
||||||
|
|
||||||
|
#### 可选用单行命令（提供者@ssdifnskdjfnsdjk）（全局安装Python依赖）
|
||||||
|
|
||||||
|
克隆Github仓库并安装所需的Python模块。首先编辑命令开头的zndir，将其改为你想要存储`zeronet-conservancy`的路径：
|
||||||
|
|
||||||
|
`zndir="/home/user/myapps/zeronet" ; if [[ ! -d "$zndir" ]]; then git clone --recursive "https://github.com/zeronet-conservancy/zeronet-conservancy.git" "$zndir" && cd "$zndir"||exit; else cd "$zndir";git pull origin master; fi; cd "$zndir" && pip install -r requirements.txt|grep -v "already satisfied"; echo "Try to run: python3 $(pwd)/zeronet.py"`
|
||||||
|
|
||||||
|
（此命令也可用于保持`zeronet-conservancy`是最新版本）
|
||||||
|
|
||||||
|
#### 可选用脚本
|
||||||
|
- 安装通用依赖和克隆repo（如上所述）后，
|
||||||
|
运行`start-venv.sh`，它将为你创建虚拟环境并安装Python依赖
|
||||||
|
- 以后会添加更多便捷脚本
|
||||||
|
|
||||||
|
### （非官方的）Windows系统构建版本
|
||||||
|
|
||||||
|
下载并解压以下.zip压缩包
|
||||||
|
[zeronet-conservancy-0.7.10-unofficial-win64.zip](https://github.com/zeronet-conservancy/zeronet-conservancy/releases/download/v0.7.10/zeronet-conservancy-0.7.10-unofficial-win64.zip)
|
||||||
|
|
||||||
|
### 在Windows操作系统下构建
|
||||||
|
|
||||||
|
（这些说明正在测试当中，请帮助我们测试并改进它！）
|
||||||
|
|
||||||
|
- 安装Python： https://www.python.org/downloads/
|
||||||
|
- 安装在Windows下适用于Python的编译器，这对我这种非Windows用户来说是最难的一步（详见 https://wiki.python.org/moin/WindowsCompilers ，之后我会提供更多参考）
|
||||||
|
- [可选，如需获取最新开发版本]安装Git：https://git-scm.com/downloads
|
||||||
|
- [可选，如需为更好的连接性和匿名性来使用tor]安装tor浏览器：https://www.torproject.org/download/
|
||||||
|
- 打开git bash控制台
|
||||||
|
- 在命令行输入或粘贴`git clone https://github.com/zeronet-conservancy/zeronet-conservancy.git`
|
||||||
|
- 等待，直至git下载好最新的开发版本，然后继续在控制台操作
|
||||||
|
- `cd zeronet-conservancy`
|
||||||
|
- `python -m venv venv`（创建Python虚拟环境）
|
||||||
|
- `venv\Scripts\activate`（激活环境）
|
||||||
|
- `pip install -r requirements.txt`（安装Python依赖）（有些使用者反馈此命令未能成功安装所有依赖，需手动逐个安装依赖）
|
||||||
|
- （注意：如果上一步失败了，可能说明C/C++编译器未能成功安装）
|
||||||
|
- [可选，为更好的连接性和匿名性]启动Tor浏览器
|
||||||
|
- （注意：Windows可能会弹窗，提示出于“安全原因”阻止了网络访问—请选择允许访问）
|
||||||
|
- `python zeronet.py --tor_proxy 127.0.0.1:9150 --tor_controller 127.0.0.1:9151`（启动zeronet-conservancy！）
|
||||||
|
- [需要完全匿名，要用如下方式启动]`python zeronet.py --tor_proxy 127.0.0.1:9150 --tor_controller 127.0.0.1:9151 --tor always`
|
||||||
|
- 在浏览器中访问http://127.0.0.1:43110
|
||||||
|
|
||||||
|
构建.exe文件
|
||||||
|
|
||||||
|
- 按照上述步骤操作完成后，再执行
|
||||||
|
- `pip install pyinstaller`
|
||||||
|
- `pyinstaller -p src -p plugins --hidden-import merkletools --hidden-import lib.bencode_open --hidden-import Crypt.Crypt --hidden-import Db.DbQuery --hidden-import lib.subtl --hidden-import lib.subtl.subtl --hidden-import sockshandler --add-data "src;src" --add-data "plugins;plugins" --clean zeronet.py`
|
||||||
|
- dist/zeronet 路径下会包含可用的 zeronet.exe！
|
||||||
|
|
||||||
|
## 目前的局限性
|
||||||
|
|
||||||
|
* 文件传输未压缩
|
||||||
|
* 不支持私密站点
|
||||||
|
* 不支持DHT
|
||||||
|
* 不支持I2P
|
||||||
|
* 不支持中心化的模块，比如zeroid（我们正在改进！）
|
||||||
|
* 尚无可靠的垃圾信息保护措施（我们也在改进）
|
||||||
|
* 无法直接在浏览器中使用（中长期会优先解决此问题）
|
||||||
|
* 不支持数据透明
|
||||||
|
* 尚无可重现构建
|
||||||
|
* 不支持磁盘加密存储
|
||||||
|
* 尚无可重现构建（因此在部分GNU/Linux发行版之外无法构建）
|
||||||
|
|
||||||
|
|
||||||
## 现有限制
|
## 我该如何创建一个ZeroNet站点？
|
||||||
|
|
||||||
* ~~没有类似于 torrent 的文件拆分来支持大文件~~ （已添加大文件支持）
|
* 点击[仪表盘](http://127.0.0.1:43110/191CazMVNaAcT9Y1zhkxd9ixMBPs59g2um/)菜单中的 **⋮** > **"Create new, empty site"** 。
|
||||||
* ~~没有比 BitTorrent 更好的匿名性~~ （已添加内置的完整 Tor 支持）
|
* 你将被**重定向**到一个只有你可以修改的全新站点！
|
||||||
* 传输文件时没有压缩~~和加密~~ （已添加 TLS 支持）
|
* 你可以在 **data/[你的站点地址]** 目录中找到并修改你的站点内容。
|
||||||
* 不支持私有站点
|
* 修改完成后，打开你的站点，向左拖动页面右上角的“0”按钮，然后点击底部的**sign and publish**按钮。
|
||||||
|
|
||||||
|
下一步请看：[ZeroNet开发者文档](https://zeronet.io/docs/site_development/getting_started/)
|
||||||
|
|
||||||
## 如何创建一个 ZeroNet 站点？
|
## 帮助此项目持续发展
|
||||||
|
|
||||||
* 点击 [ZeroHello](http://127.0.0.1:43110/126NXcevn1AUehWFZLTBw7FrX1crEizQdr) 站点的 **⋮** > **「新建空站点」** 菜单项
|
### 成为维护者
|
||||||
* 您将被**重定向**到一个全新的站点，该站点只能由您修改
|
|
||||||
* 您可以在 **data/[您的站点地址]** 目录中找到并修改网站的内容
|
|
||||||
* 修改后打开您的网站，将右上角的「0」按钮拖到左侧，然后点击底部的**签名**并**发布**按钮
|
|
||||||
|
|
||||||
接下来的步骤：[ZeroNet 开发者文档](https://zeronet.io/docs/site_development/getting_started/)
|
我们需要更多的维护者！今天就加入吧！你不需要懂编程，这里还有很多其他工作要做。
|
||||||
|
|
||||||
## 帮助这个项目
|
### 为你的平台创建构建包
|
||||||
|
|
||||||
- Bitcoin: 1Kjuw3reZvxRVNs27Gen7jPJYCn6LY7Fg6
|
我们需要为各个主流操作系统平台提供独立构建的版本，并存入各种FLOSS仓库。如果你正在使用的Linux发行版还没有得到我们提供的相应构建包，为何不自己创建一个，或者（如果你不知道怎么做）去询问你的系统维护者呢？
|
||||||
|
|
||||||
#### 感谢您！
|
### 修复bug & 添加功能
|
||||||
|
|
||||||
* 更多信息，帮助，变更记录和 zeronet 站点：https://www.reddit.com/r/zeronet/
|
我们决心继续前进，打造一个完美的p2p网络，因此我们需要更多的帮助来实现它。
|
||||||
|
|
||||||
|
### 创建你的站点/带来你的内容
|
||||||
|
|
||||||
|
我们知道这份文档有所欠缺，但我们尽力支持任何希望迁移站点和内容的用户。请不要犹豫，随时联系我们。
|
||||||
|
|
||||||
|
### 使用并传播
|
||||||
|
|
||||||
|
告诉大家你为何选择使用0net及我们这个特别的分支！人们需要知道他们的替代方案。
|
||||||
|
|
||||||
|
### 资金支持我们
|
||||||
|
|
||||||
|
此分支由@caryoscelus创建并维护。你可以在 https://caryoscelus.github.io/donate/ 上查看捐赠方式（如果在github上阅读，也可查看侧边栏了解更多途径）。随着我们团队的不断壮大，我们也会在更友善的众筹平台上创建团队账户。
|
||||||
|
|
||||||
|
如果你想确保你的捐赠会被视作对本项目的支持，下面是一个专门的比特币地址：
|
||||||
|
1Kjuw3reZvxRVNs27Gen7jPJYCn6LY7Fg6。如需更匿名和私密的方式，以下是Monero钱包地址：
|
||||||
|
4AiYUcqVRH4C2CVr9zbBdkhRnJnHiJoypHEsq4N7mQziGUoosPCpPeg8SPr87nvwypaRzDgMHEbWWDekKtq8hm9LBmgcMzC
|
||||||
|
|
||||||
|
如果你希望通过其他方式捐赠，请随时联系维护者或创建一个issue。
|
||||||
|
|
||||||
|
# 我们在抗议的情况下使用GitHub
|
||||||
|
|
||||||
|
该项目当前托管在GitHub。但这并不理想；GitHub是一个专有的、有其商业秘密的系统，不是自由及开放源代码软件（FLOSS）。我们对使用像GitHub这样的专有系统来开发我们的FLOSS项目深感担忧。我们有一个[开放的议题页面](https://github.com/zeronet-conservancy/zeronet-conservancy/issues/89)来追踪从长远来看迁移出GitHub的进展。我们强烈建议你阅读[放弃 GitHub](https://GiveUpGitHub.org)运动以及[软件自由保护协会](https://sfconservancy.org)对其的阐述，以便了解为什么GitHub不适合托管FOSS项目。
|
||||||
|
|
||||||
|
如果你是已经停止使用GitHub的贡献者，欢迎[在notabug上查看我们的镜像](https://notabug.org/caryoscelus/zeronet-conservancy)，并在那里进行开发，或者通过[联系方式](https://caryoscelus.github.io/contacts/)直接向项目维护者发送git补丁。
|
||||||
|
|
||||||
|
无论过去还是现在，未经许可地通过GitHub Copilot使用本项目的代码的行为必须立即停止。我们不允许GitHub将本项目代码用于Copilot。
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue