Skip to content

🐧 Instalar no Linux PC

Jump to bottom
KillovSky edited this page Jun 2, 2024 · 1 revision

📝 Sumário

  1. 🔎 O que é Linux?
  2. ✓ Pré-Requisitos
  3. ⚙️ Instalando a Íris
  4. 📜 Configuração
  5. 🏁 Etapas Finais
  6. 🆙 Atualizando
  7. 🙏 Finalizando
  8. ❗ Dicas

🔎 O que é Linux?

Linux é um sistema operacional de código aberto utilizado em servidores, dispositivos embarcados e é a base de distribuições populares, como Ubuntu, Debian e Fedora. O Linux oferece estabilidade, segurança e flexibilidade, permitindo que os usuários personalizem seu ambiente de computação de acordo com suas necessidades. Sua natureza de código aberto promove colaboração global e inovação contínua. É uma alternativa bem popular e mais leve que Windows, ainda que não seja muito avançada no quesito de jogos.

O linux que foi usado neste guia é o PeppermintOS Debian, meu Linux atual, mas isso pode funcionar em quase todos os linux por ai, se o seu Linux for o Arch, um baseado nele ou um Linux que não use APT, esse guia não é para você, mas você pode simplesmente procurar por comandos substitutos ao APT desse guia para sua distro, e então seguir suas etapas finais.

✓ Pré-Requisitos

Antes de iniciar a instalação da Íris no Linux, certifique-se de atender aos seguintes Pré-Requisitos:

Note que os requisitos normais e altos têm uma margem de segurança; sua Íris pode rodar muito bem mesmo estando com valores muito abaixo dos requisitados.
Esses requisitos são baseados em usos de diferentes computadores, já as sugestões (ex: Celeron), são de comparações das peças mais ruins que TALVEZ rodariam.
Esses requisitos são apenas da Íris, seu sistema operacional pode pedir o dobro, triplo ou superior a estes, certifique-se de escolher um sistema leve para melhor desempenho.

🗑️ Básico (Uso BAIXÍSSIMO):

Recomendado para usuários com computadores mais simples, que quase não usam BOTS ou que não podem pegar uma VPS muito boa.
Exige conhecimento maior em Linux, pois rodar algo tão básico exige que seja em modo CLI!
Esses requisitos se aplicam a testes, 1 grupo com poucos participantes ou apenas PV e baixissimo nível de mensagens.
Mesmo que a Íris consiga rodar nestes pela lógica, não faz sentido usar, pois as dependências, como node e canvas, podem ser incompátiveis a longo prazo.
Não use a Íris em um computador tão ruim se tiver muitos grupos ou alto nível de mensagens! Ka-boom amigo, entendes? KA-BOOM!

  • Sistemas Operacionais: Linux CLI ou lightweight Linux, como Puppy Linux
  • RAM: 512 MBs DDR2 400 MHz ou superior
  • Processador: Single-Core 1.8 GHz com Cache L2 ou superior (e.g: AMD Athlon 64)
  • GPU: N/A
  • Espaço: 3 GBs IDE, SATA 1 ou superior
  • Conexão de Internet: 50 Mbps de fibra ótica OU 75 Mbps de WiFi comum OU superior
  • Recomendações (100% OPCIONAIS, mas fazem MUITA diferença): SWAP, CLI Mode, Conhecimento intermediário ou superior em Linux

😌 Normal (Uso MODERADO):

Recomendado para usuários novos em Linux com volume comum de mensagens e pouco menos de 10 grupos.
Não exige tanto conhecimento, copie os comandos e faça tudo automatico.

  • Sistemas Operacionais: Linux x64 C/APT, como AntiX
  • RAM: 2 GBs DDR3 667 MHz ou superior
  • Processador: Dual-Core 1.4 GHz com Cache L2 ou superior (e.g: Intel Celeron)
  • GPU: N/A
  • Espaço: 4 GBs
  • Conexão de Internet: 75 Mbps de fibra ótica OU 120 Mbps de WiFi comum OU superior
  • Outros (Opcionais, fazem POUCA diferença): SWAP, CLI, VPS, SSD SATA ou NVMEs Simples (E.g: SSDs DRAMLess <450MB/s)

💥 Ultimate (Uso de ALTA INTENSIDADE):

Recomendado para usuários que têm em torno de 10 ou mais grupos com alto volume de mensagens.
Quanto mais grupos e mensagens houver, melhor deve ser sua máquina, a Íris é muito bem otimizada, mas não espere milagres.
Tudo que tem no Normal, exceto:

  • RAM: 4 ~ 8 GBs DDR3 1600 MHz ou superior
  • Processador: Quad-Core 2.4 GHz com Cache L3 ou superior (e.g: Intel Core)
  • Espaço: 6 GBs
  • Conexão de Internet: 250 Mbps de fibra ótica OU 350 Mbps de WiFi OU superior
  • Outros (Opcionais, fazem MUITA diferença): SSD NVME ou SATA 3 (DRAM, 450MB/s ou maior), VPS ou Cloud de Alta-Performance (Empresarial) Dedicada, Conhecimento Linux básico ou superior

⚙️ Instalando a Íris

Uma vez que você tenha instalado todos os requisitos, abra um terminal e digite cd, depois copie e cole os seguintes comandos para instalar os requisitos do ambiente da Íris, você pode copiar e colar o texto inteiro abaixo se preferir.

# Atualiza os repositórios e programas
sudo apt update && sudo apt upgrade -y

# Instala os requisitos para inserção da repo do NodeJS 20 | https://github.com/nodesource/distributions
sudo apt install ca-certificates curl gnupg -y

# Cria a pasta keyrings para inserir as do NodeJS
sudo mkdir -p /etc/apt/keyrings

# Obtém a keyring do NodeJS e insere na pasta criada
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

# Instala o repositório do NodeJS no sistema
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

# Atualiza os repositórios
sudo apt update && sudo apt upgrade -y

# Instala os programas necessarios de uma só vez
sudo apt install nodejs sqlite build-essential zip unzip python2 python3 git tesseract-ocr nano -y

# Se o comando acima der erros no pacote python2, remova-o do comando e tente, depois copie e use este abaixo, se falhar de novo, ignore
# Se mais algum pacote falhar, contate o suporte
# sudo apt install python-is-python3

# Baixa o Projeto Íris
git clone https://github.com/KillovSky/Iris.git

# Entra na pasta da Íris
cd Iris

# Inicia o download dos arquivos adicionais dela
npm i

# SÓ UTILIZE ESSE COMANDO SE OS COMANDOS CANVAS ESTAREM TODOS FALHANDO!
# Desatualiza o sharp para fazer o canvas voltar a funcionar junto
# IGNORE o monte de WARN aparecendo no terminal após finalizar, não são BUGs
npm i [email protected]

# Inicia (leia o resto do tutorial primeiro)
npm start

📜 Configuração

Uma vez que você tenha instalado tudo, feito todos os procedimentos acima, siga os passos abaixo para configurar seu número como dono da Íris e mudar a senha.

👨‍💻 Método Nº1 - Usando CLI

  1. Digite cd && cd Iris && sed -i 's/MyNumber/SeuNúmero/g' lib/Databases/Configurations/config.json.

    • Você deve trocar 'SeuNúmero' pelo seu número no formato: DDI+DDD+Número.
    • O número deve ser igual ao mostrado no WhatsApp, por exemplo: 's/MyNumber/55119987654321/g'
    • Se você quiser inserir outro número manualmente, deve usar o método 2, 3 ou 4 a partir de agora.

  2. Para mudar a senha padrão, digite: cd && cd Iris && sed -i 's/IrisBOT@Root#123/NovaPassword/g' lib/Databases/Configurations/config.json.

  3. Para ativar a conexão por pairing code, digite: cd && cd Iris && sed -i 's/"pairingCode": { "value": false,/"pairingCode": { "value": true,/g' lib/Databases/Configurations/config.json.

💌 Método Nº2 - Usando nano

  1. Digite cd && cd Iris && nano lib/Databases/Configurations/config.json.

  2. Navegue até onde possui @s.whatsapp.net usando as setas do teclado, clicar com o mouse também funciona.

    • Se tiver inserido um número antes, você verá ele ali.

  3. Vá até MyNumber e apague-o, digite seu número no lugar.

    • O número deve ser igual ao mostrado no WhatsApp, por exemplo: '55119987654321'

  4. Se já tiver editado antes, e quiser adicionar outro, vá até o final da linha, onde está ] e apague-o, então adicione , "outroNú[email protected]"].

    • Troque 'outroNúmero' pelo número em questão, no mesmo jeito da dica Nº3.

  5. Vá até IrisBOT@Root#123 e apague-o, digite uma nova senha no lugar.

  6. Se desejar conectar usando o código de pareamento, vá até pairingCode e troque o false abaixo para true.

  7. Quando tiver terminado, aperte Control + O e então aperte Enter, você terá inserido com sucesso seu número, então aperte Control + X para sair.

🌐 Método Nº3 - Usando o Terminal WEB da Íris

  1. Inicie a Íris, você receberá na tela um endereço de IP e porta que é acessivel somente pela sua rede.

    • Se o IP mostrado for interno, você deve usar o IP do seu PC, ele pode ser encontrado acessando as configurações de WiFi do aparelho ou pelo comando ifconfig.

  2. Abra um navegador e digite o endereço de IP e a porta, ficando como 192.168.0.123:45678.

    • Pode aparecer um erro dizendo que a página não é segura, mas não se preocupe, isso é por conta da Íris rastrear quem ousar acessar essa página, apenas clique em 'Aceite o risco' e prossiga.
    • O rastreamento será mostrado no terminal, de forma que, se algum invasor tentar acessar caso você modifique para IP externo, você possa rastrea-lo.

  3. Insira o nome de usuario e senha mostrados no terminal, isso pode ser configurado apartir do arquivo utils.json da pasta Terminal, mas não é esse o foco desse guia.

  4. Uma vez conectado, você estará em uma página com um terminal linux diretamente no navegador, não se confunda, ele é extremamente poderoso e você NÃO DEVE brincar aqui.

  5. Digite config.owner.value.push('[email protected]');, se o terminal exibir um 2, você estará pronto para seguir, se quiser ter certeza, digite config.owner.value, então seu número deve aparecer.

  6. Digite config.secretKey.value = 'NovaSenha', se o terminal retornar a mesma, você estará pronto, se quiser ter certeza, digite config.secretKey.value, sua nova senha deve aparecer.

  7. Para salvar eternamente digite fs.writeFileSync(path.normalize(irisPath+'/lib/Databases/Configurations/config.json'), JSON.stringify(config, null, 4));, isso não deve printar nada na tela, mas se algo aparecer e não for um erro, você pode continuar.

  8. Para ter certeza de que deu certo, você pode digitar JSON.parse(fs.readFileSync(path.normalize(irisPath+'/lib/Databases/Configurations/config.json')))?.owner?.value; e se o número estiver lá, tudo ocorreu bem e seu número já está salvo.

  9. Feche o navegador, volte ao Termux e continue o guia.

    • Se quiser executar Python, Bash, Node ou outras tarefas pelo Terminal WEB, você pode! Siga esse exemplo: Indexer('bash').bash('seu comando').value;.
    • Exemplo: Indexer('bash').bash('python -c "print("123")"').value;
    • Tenha em mente que processos demorados, como APT, podem causar problemas ou levar uma eternidade para funcionar, só use o que você entender.
    • Você também pode abrir jogos com isso, por exemplo, para abrir GTA V pela Steam: Indexer('bash').bash('start steam://rungameid/271590').value;
    • Basicamente, tudo pode ser feito neste terminal, desde coisinhas simples de JavaScript a coisas avançadas, como instalações e demais, tanto na rede local, como em outro país.

🐔 Método Nº4 - Usando um Editor GUI

  1. Vá até a pasta da Íris e acesse as pastas lib, Databases, Configurations.

  2. Abra o arquivo config.json em um editor de sua preferência.

  3. Vá até onde possui @s.whatsapp.net, se tiver inserido um número antes, você verá ele ali.

  4. Vá até MyNumber e apague-o, digite seu número no lugar.

    • O número deve ser igual ao mostrado no WhatsApp, por exemplo: '55119987654321'

  5. Se já tiver editado antes, e quiser adicionar outro, vá até o final da linha, onde está ] e apague-o, então adicione , "outroNú[email protected]"].

    • Troque 'outroNúmero' pelo número em questão, no mesmo jeito da dica Nº3.

  6. Vá até IrisBOT@Root#123 e apague-o, digite uma nova senha no lugar.

  7. Se desejar conectar por pairing code, vá até pairingCode, na frente de value: haverá false, troque-o por true.

  8. Quando tiver terminado, salve e saia.

🌟 Método Nº5 - Usando o Editor Oficial da Íris

  • AVISO: Esse código não funcionará em sistemas CLI, para isso, você precisará instalar ou ter uma interface, o que pode ser complicado para iniciantes.

  1. Digite cd && cd Iris && python lib/Scripts/jsonexplorer.py

    • Você também pode abrir isso por meio da opção 16 no npm run toolbox.

  2. Aperte carregar e localize o arquivo config.json.

  3. Vá em owner e aperte no botão de expandir, vá então para value e aperte em 0, troque MyNumber por seu número.

    • O número deve ser igual ao mostrado no WhatsApp, por exemplo: '55119987654321'
    • Para inserir outro número, vá em value que está acima do 0 e aperte com botão direito do mouse, selecione Add to Array.
    • Na janela de adicionar em array, digite outroNú[email protected], como por exemplo: [email protected]

  4. Aperte em Save (Memory) para guardar o valor enquanto estiver indo editar outros.

    • Se você não apertar nesse botão, você perderá o valor que inseriu.

  5. Vá até secretKey, expanda como fez acima, aperte em value, troque IrisBOT@Root#123 por uma nova senha SEGURA.

    • Essa senha é o que determina se alguém sem dono pode executar comandos de dono.
    • Você deve manter as aspas no inicio e fim da senha.
    • Recomendação segura: Um misto de letras maiusculas, minusculas, números e simbolos, 8 digitos.
    • Lembrando que isso é uma recomendação, se você confia nos usuários, pode usar qualquer senha.

  6. Se desejar conectar por pairing code, vá até pairingCode, aperte em value, troque false por true.

    • Lembre de apertar em Save (Memory) a cada edição finalizada.

  7. Quando tiver terminado, aperte em Salvar (Arquivo) e pronto.

🏁 Etapas finais

Parabéns por chegar até aqui! Agora só resta iniciar e aproveitar, para isso, siga os próximos passsos:

  1. Digite cd && cd Iris para voltar até a pasta da Íris e então digite npm start para iniciar.

  2. Você receberá um QR code ou código de pareamento na tela, abra seu WhatsApp rapidamente e utilize-o.

🆙 Atualizando

Não atualize com isso se fez a instalação no modo Universal. Caso você queira atualizar sua Íris mantendo as suas alterações, acesse a pasta dela com o terminal e siga as etapas abaixo, se não quiser salvar alterações, pule a etapa 1 e 3.

  1. Execute git stash para guardar as alterações locais em um stash temporariamente.
  • O stash no Git é uma área temporária para armazenar alterações locais quando você precisa mudar de branch ou aplicar atualizações do repositório remoto sem fazer um commit, os comandos básicos são:

git stash: Armazena as alterações.
git stash list: Lista as alterações armazenadas.
git stash apply: Devolve as alterações salvas no stash.
git stash drop: Remove o stash mais recente.

  1. Execute o git pull para atualizar seu repositório local com as alterações do repositório remoto.

  2. Execute git stash pop para reaplicar suas alterações do stash, note que este comando aplica o stash mais recente e, em seguida, o descarta automaticamente.

❌ Conflitos

Se o git apontou conflitos entre suas alterações locais e as alterações do git pull, você infelizmente precisará resolver esses conflitos manualmente, sendo mais fácil recomeçar do zero e editar novamente.

🔄 Recomeçando

Aviso: Este método irá descartar todas as alterações locais, certifique-se de ter backup ou esteja ciente de que essas alterações serão perdidas.

Se você deseja descartar completamente as alterações locais, incluindo aquelas no arquivo de configuração, e voltar para a atualização mais recente do repositório remoto, você pode usar esses passos para isso.

  1. Descarte as alterações locais:
git reset --hard HEAD # Isso irá redefinir o seu branch para o commit mais recente, descartando todas as alterações locais.
git clean -fdx # Isso remove todos os arquivos não rastreados, incluindo aqueles que foram gerados localmente.

  1. Obtenha a atualização executando git pull, feito isso, sua Íris deverá estar atualizada, igual ao repositório remoto.

  2. Execute npm i para reinstalar ou atualizar os módulos da Íris.

  3. Para finalizar, faça a Configuração e execute npm start para iniciar.

🙏 Finalizando

Parabéns por conseguir a instalação, agora você pode aproveitar a Íris em seu total controle!

❗ Dicas

  • Tome cuidado pois Íris tem a capacidade de rodar comandos de terminal linux no WhatsApp, não dê permissão de dono a qualquer um, eles podem causar danos a você.
  • Use npm run toolbox para facilitar seu trabalho, esse comando executará um menu de ferramentas super completo.

🏠 Página Inicial

⚙️ Instruções de Instalação

📝 Documentação

👮 Políticas e Diretrizes

🆕 Changelogs

🤝 Integrações

Clone this wiki locally