diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..7e97916 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 giovn-aguiar + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md index d3ce53a..5af3fe7 100644 --- a/README.md +++ b/README.md @@ -1,124 +1,278 @@ -# 🎀 Tutorial de criação de cyberdeck usando um celular antigo ✨ +# Cyberdeck: Linux no Android -## O que é um cyberdeck? 💻🩷 +
-image +![GitHub repo size](https://img.shields.io/github/repo-size/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2) +![GitHub language count](https://img.shields.io/github/languages/count/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2) +![GitHub forks](https://img.shields.io/github/forks/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2) +![GitHub issues](https://img.shields.io/github/issues/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2) +Cyberdeck Banner +> *Cyberdecks são computadores portáteis personalizados inspirados em ficção científica, cultura hacker e estética cyberpunk. Este projeto transforma seu Android em uma central Linux portátil.* +
-Cyberdecks são computadores portáteis personalizados inspirados em ficção científica, cultura hacker e estética cyberpunk. -Normalmente são feitos reaproveitando hardware antigo, adicionando acessórios, modificações estéticas e sistemas Linux personalizados ✨ +--- -A ideia é transformar um dispositivo comum em algo único, funcional e com muita personalidade ♡ +## Índice +- [Sobre o Projeto](#sobre-o-projeto) +- [Pré-requisitos](#️pré-requisitos) +- [Instalação automática](instalação-automatica) +- [Instalação e Configuração](#instalação-e-configuração) +- [Ambientes Gráficos Suportados](#ambientes-gráficos-suportados) +- [Script](#otimização-automática) +- [Inicialização](#inicialização-automática) +- [Licença](#licença) -Neste tutorial, vamos utilizar um celular Android antigo para criar um ambiente Linux completo usando o Termux, transformando o aparelho em um mini computador portátil 💿⚡ +--- -## O que você vai precisar 🧃 +## Sobre o Projeto +Este script foi desenvolvido para automatizar a instalação de uma distribuição Linux completa com interface gráfica dentro do ambiente Termux no Android. A proposta é dar vida a um **Cyberdeck**, aproveitando ao máximo o hardware do seu dispositivo. -Lembrando que aqui estou mostrando o que vou utilizar no cyberdeck que estou criando 🎀 -Mas o mais legal de cyberdecks é que literalmente não existe regra — você pode criar utilizando até uma TV Box no lugar do celular e adaptar tudo do seu jeito ♡ +--- -- Um celular ou tablet Android 📱 -- Powerbank 🔋 -- Teclado Bluetooth ou USB ⌨️ -- Mouse Bluetooth ou USB 🖱️ -- Hub USB 🌐 -- Aproximadamente 2GB livres 💾 -- Criatividade para personalizar seu cyberdeck 💻🩷✨ +## Pré-requisitos -# Projeto Android Linux - Termux +> **Nota:** Na criação de um cyberdeck não existem regras — você pode criar utilizando desde um celular antigo até uma TV Box. Os requisitos abaixo servem como base para a nossa stack: -## Descrição +* **Dispositivo:** Android 5.0+ com conexão à internet. +* **Espaço em Disco:** Mínimo de **2 GB livres** de armazenamento interno. +* **Periféricos:** Teclado, mouse e um Hub USB/OTG. +* **Software:** Versão mais recente do [Termux via F-Droid](https://f-droid.org/packages/com.termux/). +* **Principal:** Muita criatividade. -Script de configuração automatizada para instalar e gerenciar um ambiente Linux completo no Termux. +--- -## Recursos +## Instalação automática -- Detecção automática do dispositivo e GPU -- Suporte a múltiplos ambientes desktop (XFCE4, LXQt, MATE, KDE) -- Aceleração gráfica otimizada por GPU -- Instalação simplificada e automatizada -- Compatibilidade com smartphones e tablets +Para uma configuração rápida, você pode rodar o instalador passando o ambiente gráfico desejado diretamente como parâmetro. Caso queira seguir com a instalação manual siga para [instalação e configuração](instalacao-e-configuracao). +> Verifique se o arquivo script-installation.sh está baixado e no diretório certo. -## Ambientes Desktop Suportados +Verificar a integridade do script: -| Desktop | Peso | Recomendação | -|---------|------|--------------| -| XFCE4 | Médio | Recomendado | -| LXQt | Leve | Para dispositivos antigos | -| MATE | Médio | Alternativa estável | -| KDE | Pesado | Para dispositivos poderosos | - -## Instalação - -1. Instale o [Termux](https://f-droid.org/pt_BR/packages/com.termux/) do F-Droid -2. Abra o Termux e dê permissões para acesso ao armazenamento do celular: -``` -termux-setup-storage +```bash +ls ``` -3. Desbloqueie o modo Desenvolvedor no seu aparelho -4. Em 'Opções do Desenvolvedor' desabilite a opção 'Desativar restrições de processos filhos' (ou 'Disable child process restrictions') -5. Instale o git: -``` -pkg install git +Deverá mostrar as pastas do sistema, ao baixar veja se o arquivo está na pasta Download ou em outra. + +```bash +cd Downloads/ ``` -6. Clone este repositório: + +Execute o comando abaixo no seu Termux: + +```bash +bash ~/script-instalation.sh + ``` -git clone https://github.com/lucasaguiar-la/linux-android.git + +### Parâmetros disponíveis: + +* `xfce4` +* `lxqt` +* `mate` +* `kde` + +> **Comportamento do Script:** +> * Se nenhum parâmetro for passado, o script abrirá um menu interativo para você escolher a interface. +> * Se um parâmetro inválido ou inexistente for digitado, o script adotará o `xfce4` como padrão automaticamente e seguirá com a instalação. +> +> + +Exemplo de uso: + +```bash +bash ~/script-instalation.sh xfce4 + ``` -7. Após execute: + +--- + +## Instalação e Configuração + +Siga os passos abaixo na ordem indicada para configurar o seu ambiente de forma correta: + +### Passo 1: Preparação do Android +Antes de abrir o script, precisamos ajustar as permissões e o sistema operacional: +1. Abra o **Termux** e libere o acesso ao armazenamento interno executando: +```bash + termux-setup-storage ``` + +2. Ative o **Modo Desenvolvedor** no seu aparelho Android. +3. Nas *Opções do Desenvolvedor*, procure por **"Desativar restrições de processos filhos"** (*Disable child process restrictions*) e **desative-a**. Isso evita que o Android feche o Linux em segundo plano. + +### Passo 2: Instalação do Script + +Agora vamos clonar o repositório e rodar o instalador: + +```bash +# Instala o git no Termux +pkg update && pkg install git -y + +# Clona o repositório do projeto +git clone [https://github.com/lucasaguiar-la/linux-android.git](https://github.com/lucasaguiar-la/linux-android.git) + # Acessa a pasta clonada cd linux-android -# Da permissões para executar o script -chmod +X script-termux.sh +# Concede permissão de execução ao script +chmod +x script-termux.sh -# Executa o script de instalação +# Executa o instalador ./script-termux.sh -``` -8. Selecione o ambiente desktop desejado -9. Aguarde a instalação ser concluída -10. Rode o script: -``` -# Voltar para a home -cd -#Executa o script -./start-linux.sh ``` -11. Instale o [Termux X11](https://github.com/termux/termux-x11/releases/tag/nightly) para acessar a interface gráfica -12. Abra o Termux X11 e o provedor gráfico já estará funcionando -## Detecção de Hardware +4. Durante a execução, selecione o ambiente desktop de sua preferência (veja a tabela abaixo) e aguarde a conclusão. -O script detecta automaticamente: -- **Marca do dispositivo**: Samsung, Xiaomi, etc. -- **GPU**: Adreno (Samsung/Qualcomm) ou genérica -- **Driver gráfico**: Freedom ou Zink (compatibilidade) +### Passo 3: Inicialização e Interface Gráfica -## Requisitos +Para renderizar a interface visual do Linux, usaremos o servidor gráfico do Termux: -- Android 5.0+ -- Termux instalado -- Termux: X11 -- ~2GB de espaço livre -- Conexão com internet +1. Baixe e instale o [Termux X11 (Versão Nightly)](https://www.google.com/search?q=https://github.com/termux/termux-x11/releases/tag/nightly) no seu Android. +2. No Termux, inicie o ambiente Linux rodando: -## Notas +```bash + cd && ./start-linux.sh -- Use XFCE4 para melhor equilíbrio entre performance e funcionalidade -- Dispositivos antigos: prefira LXQt -- Dispositivos topo de linha: experimente KDE -- Para executar automatizamente o `./start-linux.sh` toda vez que abrir o Termux, faça o seguinte: ``` + +3. Abra o aplicativo **Termux X11** que você instalou. A interface gráfica do Linux já estará rodando! + +--- + +## Ambientes Gráficos Suportados + +| Ambiente | Performance | Recomendação de Uso | +| --- | --- | --- | +| **XFCE4** | 🟢 Média | **Recomendado**. | +| **LXQt** | 🟢 Muito Leve | Ideal para dispositivos fracos. | +| **MATE** | 🟡 Média | Alternativa estável. | +| **KDE** | 🔴 Pesado | Visual moderno e completo. Indicado apenas para dispositivos topo de linha. | + +--- + +## Script + +O script possui um sistema inteligente de detecção de hardware que configura o ecossistema de forma otimizada para o seu chip: + +* **Hardware:** Identificação automática da marca (Samsung, Xiaomi, etc.). +* **Gráficos:** Detecção de GPUs Adreno (Qualcomm) ou genéricas. +* **Drivers:** Seleção automática entre os drivers gráficos *Freedom* ou *Zink* para máxima compatibilidade e aceleração de hardware. + +--- + +## Inicialização + +Se você quer transformar seu dispositivo de forma definitiva em um Cyberdeck e deseja que o Linux inicie **automaticamente** assim que você abrir o Termux, siga estes passos: + +```bash +# Abre o arquivo de configuração do terminal nano ~/.bashrc -# Cole o conteúdo abaixo: +``` + +Adicione a seguinte linha ao final do arquivo: + +```bash ./start-linux.sh + ``` +Salve o arquivo (`CTRL + O`, depois `Enter`) e saia (`CTRL + X`). + +--- + +## FAQ + +Aqui estão as respostas para as dúvidas mais comuns sobre o projeto. Clique na pergunta para expandir. + +
+1. Consigo rodar o VS Code, Chrome ou programas pesados nesse ambiente? +
+O VS Code (versão OSS para ARM64) e navegadores como o Chromium rodam, mas o desempenho depende diretamente do processador e da RAM do seu Android. Dispositivos com menos de 4GB de RAM podem sofrer travamentos ao abrir muitos apps ao mesmo tempo. +
+ +
+2. O projeto precisa de ROOT no celular? +
+Não! O script foi projetado para rodar completamente em modo rootless (sem root) usando o PRoot para emular o sistema de arquivos Linux. Isso garante que qualquer aparelho saia de fábrica pronto para virar um Cyberdeck sem riscos de segurança. +
+ +
+3. Por que meu Linux fecha sozinho depois de alguns minutos? +
+Isso geralmente acontece porque o sistema de gerenciamento de bateria do Android (especialmente em interfaces como MIUI, OneUI ou em aparelhos Android 12+) "mata" processos em segundo plano. Certifique-se de seguir o Passo 1 (Desativar restrições de processos filhos) na seção de Instalação para corrigir isso. Vale ressaltar que o Termux e Termux X11 você deve verificar a restrição de uso de bateria. Geralmente fica em Economia de bateria (Battery saver), mude para Sem restrições (No restrictions). +
+ +
+4. Posso instalar jogos da Steam ou apps de PC normal (.exe ou x86)? +
+ +Nativamente não, porque o seu Android usa um processador de arquitetura ARM, e a maioria dos softwares de PC comuns são feitos para arquitetura x86/x64. Para rodar programas x86, você precisaria configurar ferramentas de tradução como o Box64 ou Fex-Emu dentro do ambiente. Entretanto, isso não lhe impedi de testar jogos de plataformas como Steam, Heroic, Epic Games, etc e análisar o seu desempenho (recomendo compartilhar sua experiência com a comunidade), os principais problemas que você deve encontrar é seu processador, memória RAM, armazenamento interno, etc. +
+ +
+5. O som e o microfone funcionam dentro do Linux? +
+Para o áudio funcionar, é necessário configurar o servidor PulseAudio no Termux. O script atual foca na estabilidade do ambiente gráfico. +
+ +
+6. Qual a diferença entre usar o modo DeX, uma Custom ROM ou este Cyberdeck? +
+ +Se você quer usar o Android como um computador, existem três caminhos principais. Cada um oferece um nível diferente de controle, liberdade e conhecimento técnico: + +* Samsung DeX (e similares): É apenas uma "roupagem" visual (Launcher) oficial sobre o próprio Android. Os aplicativos ainda são os apps normais do celular (.apk). É estável, mas totalmente limitado às regras da fabricante. Você não tem um terminal Linux real nem pode instalar pacotes via apt ou outro Gerenciador de Pacotes. +* Custom ROM (Ex: LineageOS): Uma Custom ROM é uma versão do Android modificada por desenvolvedores e entusiastas que oferece uma experiência adaptada e otimizada. Essas ROMs trazem recursos ausentes nas builds oficiais dos fabricantes, como melhorias de desempenho, novas funções, interfaces personalizadas e a possibilidade de remover apps pré‑instalados indesejados. +* Cyberdeck: Roda um Linux completo e independente lado a lado com o seu Android atual através de emulação no espaço de usuário (usando PRoot e Termux X11). O risco é **zero** (não precisa de root), você mantém as funções do celular intactas e ganha total liberdade de um ecossistema Linux real. + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaSamsung DeXCustom ROMCyberdeck
Risco de quebrar o aparelho⚪ Nenhum🔴 Risco de Brick⚪ Nenhum
Exige modificação avançadaNão (Nativo apenas para Samsung)Sim (Desbloquear Bootloader)Não (Apenas instalar apps)
O que roda por baixoApps AndroidROM modificadaDistribuição Linux
Ferramentas de DevMuito limitadoDepende da ROM instalada, liberdade totalLiberdade Total
+
+
+ +--- + ## Licença -MIT +Este projeto está sob a licença correspondente do repositório. Veja o arquivo [LICENSE](LICENSE) para mais detalhes. diff --git a/changelog.md b/changelog.md new file mode 100644 index 0000000..cb301ab --- /dev/null +++ b/changelog.md @@ -0,0 +1,27 @@ +# Changelog + +Todas as alterações feitas no repositório serão encontradas nesse arquivo. + +## v1.1 + +**Adicionado** +* `changelog.md` criado +* `LICENSE` criado + +**Modificado** +* `README.md` adicionado aba de FAQ + +--- + +## v1.2 + +**Adicionado** +* `segurity.md` criado + +--- + +## v1.3 + +**Adicionado** +* `contribuing.md` criado +* `code-of-conduct.md` criado diff --git a/code-of-conduct.md b/code-of-conduct.md new file mode 100644 index 0000000..322e675 --- /dev/null +++ b/code-of-conduct.md @@ -0,0 +1,38 @@ +# Código de Conduta - linux-android + +## Nosso Compromisso + +No interesse de promover um ambiente aberto e acolhedor, nós, como colaboradores e mantenedores, nos comprometemos a fazer com que a participação em nosso projeto e em nossa comunidade seja uma experiência livre de assédio para todos, independentemente da idade, tamanho corporal, deficiência, etnia, características sexuais, identidade e expressão de gênero, nível de experiência, educação, status socioeconômico, nacionalidade, aparência pessoal, raça, religião ou identidade e orientação sexual. + +## Nossos Padrões + +Exemplos de comportamentos que contribuem para um ambiente positivo para a nossa comunidade incluem: + +* Demonstrar empatia e gentileza com outras pessoas +* Ser respeitoso com opiniões, pontos de vista e experiências divergentes +* Dar e aceitar feedbacks construtivos de forma graciosa +* Focar no que é melhor não apenas para nós como indivíduos, mas para toda a comunidade + +Exemplos de comportamentos inaceitáveis incluem: + +* O uso de linguagem ou imagens de teor sexual, bem como atenção ou avanços sexuais indesejados +* Trolling, comentários insultuosos ou depreciativos e ataques pessoais ou políticos +* Assédio público ou privado +* Publicar informações privadas de terceiros, como endereço físico ou eletrônico (e-mail), sem permissão explícita +* Qualquer outra conduta que possa ser razoavelmente considerada inadequada em um ambiente profissional + +## Nossas Responsabilidades + +Os mantenedores do projeto são responsáveis por esclarecer e impor nossos padrões de comportamento aceitável e tomarão medidas corretivas apropriadas e justas em resposta a quaisquer instâncias de comportamento inadequado. + +Os mantenedores do projeto têm o direito e a responsabilidade de remover, editar ou rejeitar comentários, commits, códigos, issues e outras contribuições que não estejam alinhadas a este Código de Conduta, ou de banir temporária ou permanentemente qualquer colaborador por outros comportamentos que considerem inadequados, ameaçadores, ofensivos ou prejudiciais. + +## Escopo + +Este Código de Conduta se aplica a todos os espaços da comunidade e também se aplica quando um indivíduo está representando oficialmente a comunidade em espaços públicos. Exemplos de representação da nossa comunidade incluem publicações por meio de uma conta oficial em redes sociais. + +## Execução + +Instâncias de comportamento abusivo, de assédio ou inaceitável de outra forma podem ser relatadas aos líderes da comunidade. Todas as reclamações serão revisadas e investigadas de maneira rápida e justa. + +Todos os líderes da comunidade são obrigados a respeitar a privacidade e a segurança de quem reportou qualquer incidente. diff --git a/contribuing.md b/contribuing.md new file mode 100644 index 0000000..8656f98 --- /dev/null +++ b/contribuing.md @@ -0,0 +1,64 @@ +# Contribuindo para linux-android + +Antes de mais nada, obrigado por dedicar seu tempo para contribuir! ❤️ + +Todos os tipos de contribuição são bem-vindos e valorizados. Consulte o [Sumário](sumario) para conhecer as diferentes maneiras de ajudar e detalhes sobre como o projeto as gerencia. Certifique-se de ler a seção relevante antes de fazer sua contribuição. + +> E se você gosta do projeto, mas não tem tempo para contribuir, tudo bem. Existem outras formas simples de apoiar o projeto e demonstrar seu reconhecimento, pelas quais também ficaremos muito felizes: +> * Dê uma estrela (Star) no projeto +> * Tweete sobre ele +> * Mencione este projeto no readme do seu próprio projeto + +## Sumário + +* [Código de Conduta](codigo-de-conduta) +* [Tenho uma Dúvida](tenho-uma-duvida) +* [Quero Contribuir](quero-contribuir) +* [Sugerindo Melhorias](sugerindo-melhorias) + +--- + +## Código de Conduta +Este projeto e todos os participantes dele são regidos pelo +[Código de Conduta do linux-android](https://github.com/giovn-aguiar/linux-android/blob/master/code-of-conduct.md). +Ao participar, espera-se que você respeite este código. + +--- + +## Tenho uma Dúvida +Antes de abrir uma dúvida, o ideal é pesquisar por [Issues](https://github.com/giovn-aguiar/linux-android/issues) existentes que possam te ajudar. Caso encontre uma issue relevante e ainda precise de esclarecimentos, você pode deixar sua pergunta nela. + +Se, após isso, você ainda sentir necessidade de perguntar e precisar de esclarecimentos, recomendamos o seguinte: + +* Abra uma [Issue](https://github.com/giovn-aguiar/linux-android/issues). +* Forneça o máximo de contexto possível sobre o problema que está enfrentando. +* Informe as versões do projeto e da plataforma (termux, android, etc), dependendo do que for relevante. + +Nossa equipe cuidará da issue o mais rápido possível. + +## Quero Contribuir + +> ### Aviso Legal +> +> +> Ao contribuir para este projeto, você deve concordar que é o autor de 100% do conteúdo, que possui os direitos necessários sobre ele e que o conteúdo que você contribui pode ser disponibilizado sob a licença do projeto. + +### Sugerindo Melhorias + +Esta seção guiará você no envio de sugestões de melhorias para o linux-android, **incluindo funcionalidades completamente novas e pequenas melhorias em recursos existentes**. Seguir estas diretrizes ajudará os mantenedores e a comunidade a entender sua sugestão e a encontrar sugestões relacionadas. + +#### Antes de Enviar uma Melhoria + +* Certifique-se de que está utilizando a versão mais recente. +* Faça uma [busca](https://github.com/giovn-aguiar/linux-android/issues) para ver se a melhoria já foi sugerida. Se já foi, adicione um comentário na issue existente em vez de abrir uma nova. +* Avalie se a sua ideia se encaixa no escopo e nos objetivos do projeto. Cabe a você apresentar argumentos sólidos para convencer os desenvolvedores do projeto sobre os méritos dessa funcionalidade. Tenha em mente que buscamos recursos que sejam úteis para a maioria dos nossos usuários e não apenas para um pequeno grupo. + +#### Como Enviar uma Boa Sugestão de Melhoria? + +As sugestões de melhorias são rastreadas como [GitHub issues](https://github.com/giovn-aguiar/linux-android/issues). + +* Use um **título claro e descritivo** para a issue. +* Forneça uma **descrição passo a passo da melhoria sugerida** com o máximo de detalhes possível. +* **Descreva o comportamento atual** e **explique qual comportamento você esperava ver em vez dele** e o porquê. Neste ponto, você também pode informar quais alternativas não funcionaram para você. +* Se desejar, você pode **incluir capturas de tela ou gravações de tela** que ajudem a demonstrar as etapas ou apontar a parte relacionada à sugestão. +* **Explique por que essa melhoria seria útil** para a maioria dos usuários do linux-android. Você também pode apontar outros projetos que resolveram isso melhor e que poderiam servir de inspiração. diff --git a/image.png b/image.png new file mode 100644 index 0000000..31b70c9 Binary files /dev/null and b/image.png differ diff --git a/script-installation.sh b/script-installation.sh new file mode 100644 index 0000000..a338326 --- /dev/null +++ b/script-installation.sh @@ -0,0 +1,94 @@ +#!/bin/bash + +# ========================================================================== +# ⚡ Cyberdeck: Linux no Android - Script de Instalação e Configuração +# ========================================================================== + +cat << 'EOF' + /$$$$$$ /$$ /$$ /$$ + /$$__ $$ | $$ | $$ | $$ +| $$ \__/ /$$ /$$| $$$$$$$ /$$$$$$ /$$$$$$ /$$$$$$$ /$$$$$$ /$$$$$$$| $$ /$$ +| $$ | $$ | $$| $$__ $$ /$$__ $$ /$$__ $$ /$$__ $$ /$$__ $$ /$$_____/| $$ /$$/ +| $$ | $$ | $$| $$ \ $$| $$$$$$$$| $$ \__/| $$ | $$| $$$$$$$$| $$ | $$$$$$/ +| $$ $$| $$ | $$| $$ | $$| $$_____/| $$ | $$ | $$| $$_____/| $$ | $$_ $$ +| $$$$$$/| $$$$$$$| $$$$$$$/| $$$$$$$| $$ | $$$$$$$| $$$$$$$| $$$$$$$| $$ \ $$ + \______/ \____ $$|_______/ \_______/|__/ \_______/ \_______/ \_______/|__/ \__/ + /$$ | $$ + | $$$$$$/ + \______/ +EOF + +# Permissão de armazenamento +echo -e "\n[1/5] Solicitando acesso ao armazenamento interno..." +termux-setup-storage +sleep 2 + +# Atualiza os pacotes e instala o Git +echo -e "\n[2/5] Atualizando o Termux e instalando o Git..." +pkg update -y && pkg upgrade -y +pkg install git -y + +if [ $? -ne 0 ]; then + echo -e "Nota: Se a atualização falhar, certifique-se de estar usando a versão do F-Droid." +fi + +# Clone do Repositório +echo -e "\n[3/5] Clonando o repositório linux-android..." + +# Verifica se a pasta já existe, caso ele com o git clone +if [ -d "linux-android" ]; then + echo "A pasta 'linux-android' já existe. Atualizando repositório existente..." + cd linux-android && git pull +else + git clone https://github.com/lucasaguiar-la/linux-android.git + cd linux-android +fi + +# Verificação do parâmetro de ambiente gráfico +if [ -z "$1" ]; then + echo -e "\nAlerta: Voce nao escolheu um ambiente grafico via parametro. O padrao sera xfce4." + AMBIENTE_PARAM="xfce4" +else + AMBIENTE_PARAM=$(echo "$1" | tr '[:upper:]' '[:lower:]') +fi + +# Ambiente gráfico +echo -e "\n[4/5] Configurando o Ambiente Gráfico..." + +if [ "$AMBIENTE_PARAM" = "xfce4" ] || [ "$AMBIENTE_PARAM" = "lxqt" ] || [ "$AMBIENTE_PARAM" = "mate" ] || [ "$AMBIENTE_PARAM" = "kde" ]; then + case $AMBIENTE_PARAM in + xfce4) AMBIENTE="XFCE4";; + lxqt) AMBIENTE="LXQt";; + mate) AMBIENTE="MATE";; + kde) AMBIENTE="KDE";; + lockesinc) AMBIENTE="XFCE4";; + esac +else + echo "------------------------------------------------------" + echo "Escolha a interface gráfica desejada para o seu Cyberdeck:" + echo -e "1) XFCE4 (Recomendado - Melhor equilíbrio de performance)" + echo -e "2) LXQt (Muito Leve - Ideal para dispositivos antigos)" + echo -e "3) MATE (Média - Alternativa clássica e estável)" + echo -e "4) KDE (Pesado - Apenas para dispositivos modernos/topo de linha)" + echo "------------------------------------------------------" + read -p "Digite o número da sua opção (1-4): " opcao + + case $opcao in + 1) AMBIENTE="XFCE4";; + 2) AMBIENTE="LXQt";; + 3) AMBIENTE="MATE";; + 4) AMBIENTE="KDE";; + *) echo -e "Opção inválida. Definindo o padrão recomendado (XFCE4)."; AMBIENTE="XFCE4";; + esac +fi + +echo -e "\nSelecionado: $AMBIENTE. Iniciando o instalador principal..." + +# Concede permissão de execução e roda o script interno do repositório clonado +chmod +x script-termux.sh +./script-termux.sh + +# Instalação conluido +echo -e "\n======================================================" +echo -e "Instalação do script concluido!" +echo -e "======================================================" diff --git a/segurity.md b/segurity.md new file mode 100644 index 0000000..57a96a0 --- /dev/null +++ b/segurity.md @@ -0,0 +1,39 @@ +# Política de Segurança + +Valorizamos a segurança do projeto **Cyberdeck: Linux no Android**. Se você descobrir uma vulnerabilidade de segurança neste ecossistema, encorajamos fortemente que nos avise de forma privada para que possamos corrigir o problema o mais rápido possível. + +--- + +## Versões Suportadas + +Apenas a versão mais recente do repositório recebe atualizações de segurança de forma ativa. + +| Versão | Suportada | +| :--- | :--- | +| **Atual (Main)** | Sim | +| **< Antigas** | Não | + +--- + +## Como Reportar uma Vulnerabilidade + +> **Por favor, NÃO abra uma Issue pública para relatar falhas de segurança.** + +## Como Reportar uma Vulnerabilidade + +Se você encontrar um problema que possa comprometer a integridade do dispositivo do usuário, siga os passos abaixo: + +1. **Vulnerabilidades Críticas:** + * Pedimos que **não** publique um passo a passo detalhado (exploit) diretamente no fórum público para evitar que a falha seja explorada maliciosamente antes de ser corrigida. + * Abra uma **Issue aqui no GitHub** descrevendo o problema de forma clara e organizada (ex: *"Falha encontrada na validação do parâmetro X do script de instalação"*) e informe que possui os detalhes da correção. + +2. **Bugs de Segurança Simples ou Configurações Inseguras:** + * Podem ser discutidos diretamente na aba de **Issues** deste repositório ou no canal de fórum do Discord da comunidade, idealmente já propondo uma solução ou *Pull Request* para corrigir o problema. + +--- + +## Considerações Importantes + +Este projeto roda em modo *rootless* (sem root) dentro do espaço de usuário do Android através do Termux e PRoot. Isso significa que: +* O ambiente Linux está isolado dentro do armazenamento do Termux, mitigando riscos de danificar o sistema operacional nativo do celular. +* No entanto, qualquer script ou programa executado dentro do ambiente Linux tem acesso à internet e às permissões que o usuário concedeu ao Termux (como acesso ao armazenamento interno). Tenha cuidado ao rodar códigos de terceiros dentro do seu Cyberdeck.