GNU General Public License v3.0

项目介绍

RROrg/rr 是一个托管在 GitHub 上的开源项目,主要使用 Shell 编写,采用 GNU General Public License v3.0 许可证,目前获得 8.8k 个 Star、1.4k 次 Fork。

仓库全名
RROrg/rr
开源许可证
GNU General Public License v3.0
Star 数
8.8k
Fork 数
1.4k
未关闭 Issue
103

README 摘要

RR: redpill’s preinstallation and recovery environment The ultimate solution to self-centralized Synology DSM OS on any local machine with any x86/x64 CPU architecture via a single flash of bootload pre-installation process in addition within recovery environment. 1: Disclaimer 硬盘有价,数据无价,任何对引导的修改都是有风险的,本人/组织不承担数据丢失的责任。本工具仅用作学习交流,严禁用于商业用途。 Hardware/hard-drives are priced whilst data are priceless, any user-specific…

完整内容见 GitHub 原始 README 或本页 。

常见问题

rr 用什么语言开发?

主要使用 Shell 编写,采用 GNU General Public License v3.0 许可证,目前有 8.8k 个 Star。

rr 可以免费商用吗?

仓库标注的许可证为 GNU General Public License v3.0,商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 rr 的源码?

可以直接克隆仓库:git clone https://github.com/RROrg/rr.git,默认分支为 main;安装与运行步骤见仓库 README。

rr 最近还在维护吗?

仓库最近一次更新为 9月19日,当前有 103 个未关闭 Issue;Star 数为 8.8k,可作为社区活跃度的参考。

简要分析

热度分
11597
价值分
5673
活跃状态
活跃

语言占比

Python
Shell

Release

README

logo

RR: redpill’s preinstallation and recovery environment

GitHub Release GitHub Downloads (all assets, all releases) GitHub Issues or Pull Requests by label

The ultimate solution to self-centralized Synology DSM OS on any local machine with any x86/x64 CPU architecture via a single flash of bootload pre-installation process in addition within recovery environment.

1: Disclaimer

  • 硬盘有价,数据无价,任何对引导的修改都是有风险的,本人/组织不承担数据丢失的责任。本工具仅用作学习交流,严禁用于商业用途。

  • Hardware/hard-drives are priced whilst data are priceless, any user-specific custom modification of the tested & prebuilt bootloader images could potentially cause irreversible data destruction towards your local machine. Us, as (RROrg) are not responsibly liable for damage nor personal loss of any types. The project with its affiliation is released for educational and learning purpose only, commercial application of the software is strictly prohibited.

2: Documentation & FAQ

3: Components

  • During the compilation process, you need to connect to the Internet to obtain model and version information and download the corresponding ROM. If you cannot connect to the Internet, please build a pre-compiled bootloader through RR-CUSTOM.

  • Proxmox VE One Click Install:

    curl -fsSL https://github.com/RROrg/rr/raw/refs/heads/main/scripts/pve.sh | bash -s -- --bltype usb
    
    # Optional Parameters:
    --onboot <0|1>           Enable VM on boot, default 1 (enable)
    --efi <0|1>              Enable UEFI boot, default 1 (enable)
    --bltype <sata|usb|nvme> Bootloader disk type, default sata
    --storage <name>         Storage name for images, as local-lvm, default auto get
    --v9ppath <path>         Set to /path/to/9p to mount virtio 9p share
    --vfsdirid <dirid>       Set to <dirid> to mount virtio fs share
    --tag <tag>              Image tag, download latest release if not set
    --img <path>             Local image path, use local image if set
    
  • Docker Compose:

    # 请从最新版本中下载 rr.img 文件。
    # 并将 <path_to_rr.img> 替换为你的 rr.img 文件的实际路径.
    # Please download the rr.img file from the latest release.
    # And replace <path_to_rr.img> with the actual path to your rr.img file.
    
    version: "3.9"
    services:
      rr:
        image: qemux/qemu:latest
        container_name: rr
        environment:
          BOOT: ""
          RAM_SIZE: "4G"  # >= 4G recommended for DSM
          CPU_CORES: "2"
          DISK_FMT: "qcow2"
          DISK_TYPE: "sata"
          DISK_SIZE: "32G"  # data disk size
          ARGUMENTS: "-device nec-usb-xhci,id=usb0,multifunction=on -drive file=/rr.img,media=disk,format=raw,if=none,id=udisk1 -device usb-storage,bus=usb0.0,port=1,drive=udisk1,bootindex=999,removable=on"
        devices:
          - /dev/kvm
          - /dev/net/tun
        cap_add:
          - NET_ADMIN
        ports:
          - 5000:5000  # For DSM management
          - 5001:5001  # For DSM management
          - 7681:7681  # For RR management
          - 7304:7304  # For RR management
          - 7080:7080  # For RR management
          - 8006:8006  # For QEMU management
        volumes:
          - ./rr.img:/rr.img  # <path_to_rr.img>:/rr.img
          - ./data:/storage
        restart: always
        stop_grace_period: 2m
    
    

4: GPU:

5: Contributing

  • The following is a roughly truncated guide to involve in project localization for internationalization.
# If deletion nor addition proces of code hunk is not required, comply with the following process
sudo apt install gettext
git clone https://github.com/rrorg/rr.git
cd files/initrd/opt/rr
xgettext -L Shell --keyword=TEXT *.sh -o lang/rr.pot
sed -i 's/charset=CHARSET/charset=UTF-8/' lang/rr.pot
# If you have to replace certain language string of the project, please suggest and modify translation changes within each correlated PO file
mkdir -p lang/zh_CN/LC_MESSAGES
msginit -i lang/rr.pot -l zh_CN.UTF-8 -o lang/zh_CN/LC_MESSAGES/rr.po
# Update translation files
for I in $(find lang -path *rr.po); do msgmerge --width=256 -U ${I} lang/rr.pot; done
# This formatting process will be automatically conducted during packaging.
for I in $(find lang -path *rr.po); do msgfmt ${I} -o ${I/.po/.mo}; done
  • PRs of new language translations towards the project is welcomed with appreciation.

  • Community maintainers of each supporting list of languages are accredited below.

    • de_DE: @Tim Krämer: Tim Krämer
    • en_US: @rrorg
    • ja_JP: @andatoshiki & @toshikidev
    • ko_KR: @EXP : jeong1986
    • ru_RU: @Alex: TG
    • tr_TR: @miraç bahadır öztürk: miracozturk
    • vi_VN: @Ngọc Anh Trần: mr.ngocanhtran
    • zh_CN: @rrorg
    • zh_HK: @rrorg
    • zh_TW: @March Fun: 豪客幫

6: Acknowledgment & Credits

7.1: Group

7: Sponsoring

8: License

评论

暂无评论